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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


he Raspberry Pi is the most versatile 

computer in existence. Thanks to its low 

cost, small size, and those handy GPIO pins, 
you can turn it into just about anything. 

But you’ve got to start somewhere. And many 
Raspberry Pi owners start out with a media 
centre project. 

This makes sense. With its HDMI socket and 
small form factor, the Raspberry Pi can quickly 
become a much more versatile media player than 
the ones you’d buy in the shops. 

Starting on page 16, we’ve got a range of sound 
and vision projects that can put your Raspberry Pi 
at the heart of your entertainment. With it you can 
stream movies, play television shows, and listen to 
music tracks and radio. It’s a great introduction to 
digital making with a Raspberry Pi. 

Further inside the magazine, you’ll discover 
stories from other makers about the incredible 
things they’ve built. This month has one of the 
finest selections of creations on earth. We’ve got a 
real-life Pac-Man game built using robots (page 30) 
and a robot called Rosie that can play the TV game 
show Countdown (page 32). 

Raspberry Pi is acommunity, and it’s the 
amazing things our readers build and share that 
make it special. Good luck with your next project 
and don’t forget to share it with us. 


Lucy Hattersley 
Editor 
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SPECTRE 


Discover 

how the Spectre 
and Meltdown 
exploits work later 
in the magazine 


Your Pi is 

immune from 
Meltdown and 
Spectre because 
its processor 
does not have the 
hardware these 
viruses exploit 


RASPBERRY P 


TO SPECTRE & MELTDOWN 


It’s a good time to use a Raspberry Pi for online banking 


hile some ARM processors 
are vulnerable to the 
Spectre and Meltdown 
exploits you may have heard about, 
every model of Raspberry Pi is not. 
Both hacks exploit a 
weakness in how modern 
processors increase their 
efficiency by predicting and 
reordering instructions. 
Very basically, Meltdown 
and Spectre exploit a processor 
performance technique known 
as speculative execution, which 
tries to pre-execute certain 
instructions before the CPU knows 
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FCC 10: 2ABCB-RPI32 
EC: 20053-RP132 


whether they are really needed. If 
they are not needed, the results 
are thrown away, but changes to 
the state of the processor’s data 


have accessed sensitive data, 
the hacks can read the data by 
analysing these changes, even 
though the instruction never 


Stay safe in the knowledge 
that the Raspberry Pi 


is not affected 


cache caused by the unneeded 
instructions are not undone 
during the throwing away process. 
If an unneeded instruction would 
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really executed. Spooky! Sensitive 
data can contain personal and 
private data, including passwords. 
It’s a bit tricky to explain as it 
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involves some seriously niche, 
low-level computing stuff that 
the vast majority of people would 
never have to come across — 
unfortunately, that does not make 
it any less dangerous. 

But we live and breathe this 
sort of thing, and Raspberry Pi 
co-founder Eben Upton goes into 
it in detail in a tutorial this month 
(see page 48). It’s an excellent 
read that explains one of the most 
intricate aspects of technology in 
an accessible way. 


Pi CPU is immune 

As Arm Holdings revealed 
(magpi.cc/2mg9lIg6j), the 
processors used in every model 
and version of the Raspberry Pi 
(the ARM1176, Cortex-A7, and 
Cortex-A53) are not vulnerable to 
Spectre or Meltdown attacks. The 
processors used in Raspberry Pi 
boards don’t feature the hardware 
that Spectre or Meltdown exploits. 

“The lack of speculation in 
the ARM1176, Cortex-A7, and 
Cortex-A53 cores used in Raspberry 
Pi render us immune to attacks 
of the sort,” says Eben Upton. 

So, you can stay safe in the 
knowledge that the Raspberry Pi 
is not affected — while patches 
are rolled out for other devices, 
at least you now know which 
computer in your house is the 
most secure for online banking. 

For systems that do use 
vulnerable processors, patches 
have been issued to create 
a kind of firewall around the 
memory that Spectre or Meltdown 
could potentially snoop. Sucha 
system comes at a performance 
cost, however, estimated to be 
something like 5%. 

If you are thinking about 
temporarily switching to the 
Raspberry Pi as a more secure 
desktop, in issue #59 we rana 
feature where we challenged 
features editor Rob to use a 
Raspberry Pias his desktop PC 
for a week (magpi.cc/2u0ZzK3). 
There are some great tips in there 
that should help you set up your Pi 
as a desktop! 
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NEW PI ZERO WH LAUNCHED 


NEW PI ZERO WH 


LAUNCHED 


Check out that new 
pre-soldered GPIO 
header. Beauty! 


pak eye 


he Raspberry Pi 
Foundation has launched 
a new Pi model, the Pi 
Zero WH. The difference between 
this edition and the current 
Pi Zero W is its pre-soldered 
GPIO header. 

Mike Buffham, Raspberry Pi 
Foundation Director of Product 
Management, explains that the 
new Zero WH has been launched 
“to support those customers 
who did not want to or feel 
comfortable with soldering the 
header themselves.” 

While Mike clarifies that “it 
seemed sensible” to solder 
the GPIO header on during 
manufacture, the move is “not 
completely simple.” As the GPIO 
header is soldered to the opposite 
side to other components, this 
means “the boards have to go 
through the solder baths twice.” 

The new Pi Zero WH should 
be available through all your 
favourite retailers by the time 
you read this. 
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FOR MANCHESTER SCHOOLS 


Web hosting company UKFast to invest £100 000 


The five 

new Pi Cafés 

will operate 
much like the 
pilot site in 
Broadoak School, 
Partington 


ollowing a successful pilot 

in 2015, web hosting firm 

UkKFast has announced 
five further ‘Raspberry Pi Cafés’ 
for Manchester schools this year. 
The project represents a £100000 
investment from UKFast. 

Aaron Saxon, UKFast’s Director 
of Training and Education, reveals, 
“We are distributing 120 Pis 
across the five sites: Holy Name 
RC Primary School in Moss Side, 
St Bede’s Prep School in Hulme, 
Alderley Edge School for Girls, 
The Hollins Technology College 
in Accrington, and The Factory 
Youth Zone in North Manchester.’ 


> 
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The sites were chosen “where 
gaps in digital engagement exist”, 
Aaron explains. This includes areas 
lacking “the resources to deliver 
cutting-edge digital training, as 
well as all-girl schools which have 
traditionally seen low uptake in 
technical subjects.” 


“there will be arcade, old-school 
gaming, and robotics cases” 
Aaron says. “We're providing the 
technology for the children in a fun 
and exciting way.” 

Paul Grier, Network Manager 
at St Bede’s Prep School (one of 
the five new sites), adds that “in 


Were providing the 
technology for the children 
in afun and exciting way 


School café 

We asked Aaron how the Pi Cafés 
would actually operate, and it 
seems that’s largely up to the 
schools: “Some schools may use 
it as acreative space, others will 
use it as their computer science 
classroom as well as an extra- 
curricular hub and space for 

the community.” 

The Pis in question “won’t look 
like traditional desktop units,” 
Aaron tells us, “as we want them 
to be more computer-science 
focused.” For UKFast, that means 


20 years’ time, 45% of jobs will be 
done by Al and robots. So if kids 
today don’t understand [these 
things], they won’t understand 
how the world works.” 

Paul says he hopes the new Pi 
Café will “allow both children and 
the staff [of St Bede’s] to delve 
more into computer science.” 
While students and staff of 
St Bede’s “learn ICT, which is 
processing and spreadsheets,” 
Paul tells us that “programming 
hasn’t taken off as much as I would 
have liked it to.” 
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Now free for home projects 
A professional control system 
development tool 


CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. CDP Studio makes creating control projects easy, from large 
industrial systems, professional prototyping, demonstration systems and now home projects. 


CDP Studio is independent of other software and hardware providers. The system can run ona 
Raspberry Pi, supports open source libraries and with a large feature toolbox including GPIO, l2C 
and MOTT. Its built in GUI design tool and features lets you code less and do more. 


Free download on www.cdpstudio.com 


CDP Technologies AS Tel: +47 990 80 900 
Nedre Strandgate 29 info@cdptech.com 
P.O. Box 144 www.cdpstudio.com 


NO-6001 Alesund, Norway CDPStudio 


y'(27e MR BLUE PI / NEW DUAL-LAYER PROTO BOARD 


razilians can finally buy an 

official Raspberry Pi, and to 

celebrate this breakthrough 
the Brazilian Pi model has a new, 
blue PCB. 

The delay in delivering Pis to 
Brazilians was due to a regulatory 
hitch: all telecommunications 
products sold in Brazil must be 
approved by the Brazilian regulatory 
agency Anatel, and this certification 
has taken some time. 

The reasons for the delay are 
unclear, especially as the approved 
Pi is functionally identical to 
any other Pi. The only difference 
between a Brazilian Pi and any other 


MR BLUE PI 


Below Apart from the colour of 
the circuit board, the Brazilian Pi 
is identical to any other Pi 3 


Official Brazilian Raspberry Pi is blue 
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Add chips and USB ports to your quick builds 


he ALio Proto Board recently 
hit its Crowd Supply target 
(magpi.cc/2mgVz4X), 
and with a pad layout that can 
accommodate chips (ICs) it should 
be useful board to get complex 
builds running quickly. There are 
variants compatible with Arduino 
and USB ports. 
ALio Lead Engineer (and 
AERD CEO) Arief Adha tells us, 
“Currently we are on production 
for first batch [of ALio boards, 
but] my next plans are to publish 
the files [for the boards]. As Arief 
explains, “Since the board itself 
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is fully open-source, we hope 

we can make rapid prototyping 
accessible for everyone who wants 
to prototype with SMD or PTH.” 

Arief even says, “All profit that 
we’ll get [from ALio], we will 
allocate to develop new open- 
source stuff.” 

The AERD team are still focused 
on producing the ALio boards, 
however, with Arief confirming 
that “ALio is a good candidate to 
include in the Digi-Key catalogue.” 
Keep an eye on digikey.co.uk 
if ALio looks useful for your 
next build. 


is the colour of its circuit board. 

The excellently named FilipeFlop 
(filipeflop.com) is the first retailer 
to stock the new ‘Anatel’ Pis, with 
a blue Pi 3 costing RS$199.90, or 
roughly £45. 

Blue Raspberry Pi boards will 
only be on sale in Brazil — even if 
you order through Filipe Flop, you 
will only be able to buy the Blue Pi 
if you are a Brazilian resident. 
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The ALio Proto Board has pads for 

chips as well as components, with 

versions to easily add USB ports or 
make Arduino shields 
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The stories we shared that flew 
around the world 


Popular 


magpi.cc/2mf52Kk 


We've released a 
116-page guide to getting 
started with a Raspberry 
Pi, and as a bonus it comes 
with a Raspberry Pi Zero W 
mounted on the front! 

The book costs £24.99, 
from store.rpipress.cc. 


COMES TO PI 


New web browser built for Raspberry Pi boards 


he Vivaldi web browser now 
runs on your Raspberry Pi, 
bringing interesting tools 


Asked whether he sees the 
more speed-focused features as 
being more useful for Pi users, 
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such as Rewind (returning to the Jon replies: “The Pi is used for a 
first page of a site), Opera-like lot of different things.” If you use 
Speed Dial, and a ‘no-UP mode for your Pias a standard PC, having 


distraction-free surfing. a choice of powerful browsers is 
Vivaldi CEO Jon von Tetzchner handy, but Jon also claims that if magpi.ce/2\FjlaL 
tells us why the firm wanted you use you Pi “as a media player Virtual campanologists rejoice, as Mike Cook's 


to support the Pi: “We love the 
Raspberry Pi! We believe we can 
contribute positively to the Pi 
community by providing our 
browser for the platform.” 


or a games console... havinga 
fully featured browser in there 
is a perfect fit.” 
You can download Vivaldi from 
vivaldi.com to give it a try. 


comprehensive guide on building a bell-ringing 
simulator is available to all. Just head to the link above 
to practise your (virtual) pulling technique without 
annoying the entire neighbourhood! 


Raspbdian x06 
Server 


Creation Date 


magpi.cc/2mhWq5J 


Anew feature of Raspbian Desktop for x86, PiServer 
enables you to create and manage a network of Raspberry 
Pi boards from a single laptop or PC. This makes it easier 
than ever to demonstrate code and techniques to groups, 
whether that's an ICT class or a Code Club. 


Vivaldi is a fully featured web browser for your Pi 
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CIC has released the Ubi 

Kit development kit, 

which incorporates both 
Amazon’s Alexa Voice Service (AVS) 
and Google Assistant into one easy- 
to-install package. Just fire up your 

i, enter a single install command, 

and get developing. 


The Ubi Kit includes the Sensory 


embedded speech recognition 
SDK, Kitt.Al for natural language 
processing, and Congitech’s 
wake-word technology. You only 


need to add speakers and a USB 
Ubi Kit delivers Alexa and Google Assistant to your Raspberry Pi microphone (anything that runs on 
_ the Pi should work). 
= Once you’ ve installed Ubi Kit, 
you can access the Ubi Kit console 
via a web browser. This means 
Get up & running with Alexa V6iee Service & Google that you can “change WiFi, AVS 
Assistant in minutes credentials, and sign in without 
Custer needing to code or command line,” 
sent according to UCIC. 
While developing, you might be 
Ubi Kit glad that you can set the trigger 
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eompines action to the web button or the 
development : 
for Amazon's Pi’s GPIO. 
feet and asegie ® Head to ubikit.ucic.io to sign up 
ssistant into one f 
easy-to-use kit - for your kit. 


Add chips and USB ports 
to your quick builds 


orking with the Los Alamos Alamos researchers to use to Below Packing 750 Pi 
National Laboratory, develop their own next-generation i capped 
BitScope has created computers,” Bruce explains. and cooling 
a Raspberry Pi Cluster of 750 However, it’s “non-trivial to prediivelterore 
Raspberry Pi 3s in a single box get 750 Raspberry Pis (or any 
(magpi.cc/2mhiuqV). Admittedly, | type of computer, really) to work 
that box is a 35U rack server case, reliably at such high density,” 
but the computing density is “five continues Bruce: the problems are 
to ten times more dense than “power, mounting, and cooling.” 
anything before” according to Bruce confirms that the 750-node _# 
BitScope CEO Bruce Tulloch. Clusters project “needs less than 
Bruce reveals that LANL works 4kW at full tilt”, over ten times 
with “clusters of 20000+ nodes lower than a conventional air- 
capable of doing the sort of thing cooled setup. 
that would otherwise require You can learn more about 
millions of normal PCs to achieve.” BitScope Pi Clusters by visiting 
LANL’s challenge to BitScope cluster.bitscope.com. And don’t 
was to build a 3000-core ‘pilot miss our cluster computing feature 
cluster’ as “a test bed for Los this month, starting on page 64. 
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SNIPS: A NEW OPEN-SOURCE VOICE ASSISTANT 


(1) Sonos Play:1 


A NEW OPEN-SOURCE 
VOICE ASSISTANT 


Voice assistant runs locally 
to protect your privacy 


nips (snips.ai) is a new offline voice assistant that 
processes commands locally on your Raspberry Pi. 
“We realised that the main issue of the next 

decades was the way people and machines interact”, 

says Snips founder and CEO Dr Rand Hindi. “The 

more devices we want to use, the more effort it takes 

to use technology... Our mission at Snips [is] to 

put an Al assistant in every device in order to make 

technology disappear.” 


Privacy matters 

Snips’ offline nature is a response to the concerns of 
the server-side processing of most digital assistants: 
“we have come to believe that adding AI to our everyday 
devices necessarily means sacrificing our privacy, but 
we are challenging this point of view... Big servers 

are no longer needed — on-device voice recognition 
actually works!” 

Snips published test results of how its assistant 
performs in comparison to other voice services. In its 
own test, Snips was either comparably accurate or better 
(magpi.cc/2CUU7zG). 


Training and specialisation 
Snips can run offline on hardware because each assistant 
is built with a specific task in mind. As Rand puts it, “a 
coffee machine should be good at understanding various 
types of coffee, but does not have to know movie names.” 
Snips also uses “very efficient libraries, like Tensorflow, 
and a very efficient programming language, like Rust,” 
Rand clarifies. Even so, you’ll need a Pi 3 to run the full 
Snips platform. 
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Left If you want 
to build voice 
devices that 
process voice 
commands 
locally, then 
take a good 
look at Snips 
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GoPiGo 


20+ new projects for your Pi robot car. 


BrickPi3 


LEGO MINDSTORMS + RASPBERRY PI 


www.dexterindustries.com 
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pi-top 


Inspiring inventors and creators to 
seek the skills of tomorrow and 
create their Future, today. 


The modular laptop with sliding keyboard 


The modular desktop 
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pi-topPROTO pi-top AKER pi-top 


www.pi-top.com © @GetPiTop @ /GetPiTop 
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pi-top 
Clos 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular Laptop. 


Get started with 20+ inventions in the inventor's 
guide booklet. There are 3 inventor's journeys - 
Smart Robot, Music Maker and Space Race. 


pi-topCEED 


Colors 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 
form factor. Join hundreds of code clubs 
and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based Learning. 


Modular 
Accessories 


Stay up to date with our latest news by following our social media 


ne nf a 


| eee at 


pi-top is an award-winning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR* endorsed pi-topOS (Operating systern) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
learning lesson plans with pi-topCODER and have fun 


learning to code with CEEDuniverse! 


CEEDuniverse 
ey 


pi-topCODER has a fully 
integrated coding environment 
letting you program hardware 
code in Python and Learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you Learn 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, learn problem 
decomposition by solving 
visual programming puzzles. 


PROJECTS 


Power all your home media with Raspberry Pi 


he Raspberry Pi is 
incredibly versatile. While 
a lot of people use theirs 


for fun electronics projects or to 

learn how to code, many folks use 
© them in a more practical way, such 

as a media PC for their TV. The 
media capabilities of a Raspberry Pi 
are powerful and varied, though, so 
we thought we’d show you how you 
could replace (or upgrade) almost 
all of your media devices with 
some simple Raspberry Pi projects. 
Let’s enter a new world... of sound 
and vision. 
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RASPBERRY Pl 
MEDIA SERVER 


Enable network access 


MUSIC BOX 


Stream music anywhere 


Qe THEATRE PC 


Watch it on your TV 


FUTURISTIC 
PHOTO FRAME 


Make a fancy live frame ° ° 
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ALEXA VOICE 
CONTROL 


Speak your commands 
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YOU'LL NEED 


RASPBERRY PI: 
Any model will do, but we 
recommend a Pi 2 or 3 


OPERATING SYSTEM: 
We're doing this on Raspbian, 
but it will work on any other Pi OS 


OTHER HARDWARE: 


PORTABLE USB HARD DRIVE 
As big as you can afford 


WIFI DONGLE (OPTIONAL) 
Only for Pis without wireless LAN 


ETHERNET (OPTIONAL) 
O) We recommend using a wired 
connection if you can 


“Media 


Keep all your media in one place so every 
device on your network can access it 


f you’re like us, you have 
several computers in 
your house, with music 
and videos and everything spread 
between them. Some (very) smart 
folks will have figured out how 
to use cloud storage to sync it 
all. However, our solution ended 
up keeping everything on a 
centralised computer: a file server. 
Using a Raspberry Pi for this is 
perfect as well, due to its size and 
low-power consumption. 


>STEP-01 

Location, location, location 
Where you put your file server is 
very important. As well as access 
to power, you need to make sure 

it has a good connection to your 
router. In some houses, this might 
mean putting it right next to your 
router. Job done. In other houses, 
you may not have that luxury. 


Pick a few places you’d be happy 

to put it and think whether one 
spot makes more sense over the 
others. If all else fails, download a 
WiFi analyser app for your phone 
and test each spot to see which one 
might be the best. 


>STEP-02 

Basic setup 

Before you put your Pi file server in 
its final destination, hook it all up 
to a monitor, keyboard, and mouse 
so you can configure it. Make 

sure Raspbian is up-to-date, that 
you’re connected to the internet, 
and attach the USB hard drive you 
plan to use. If you need to format 
it, make sure to format it as NTFS. 
Finally, create a folder on your 
system where you’d like all your 
files to live. For this tutorial, let’s 
just create a folder called Share in 
the home folder. 


>STEP-03 

Configure your Raspberry Pi 
There’s a few things you need to 
do before setting up the Pi to share 
files over the network. First of 

all, you need to make sure the Pi 
will automatically connect to the 
external hard drive after boot. To 
do so, open the fstab file with: 


sudo nano /etc/fstab 


Add the following as one complete 
line to the bottom of the file and 
then save and exit: 


/dev/sda1 /home/pi/Share 
ntfs-3g rw,default @ 0 


>STEP-04 

Configuring Samba 

Samba is the name of the software 
that lets you easily share files over 
a network. On the Raspberry Pi, 
you need to install it with: 


sudo apt-get install samba 
samba-common-bin 


You then need to edit the 
configuration file so it knows 
where to look. Open it with: 


sudo nano /etc/samba/smb. 
conf 


CAPTAIN AMERICA 


MEDIA PLAYER PROJECTS 


And add the following to the 
bottom of the file: 


[Pi share] 

comment = Pi shared folder 
path = /home/pi/Share 
browseable = yes 

writeable = Yes 

only guest = no 

create mask = 0777 
directory mask = 0777 
public = yes 

guest ok = yes 


Save and exit. Finally, reset the 
Samba password with: 


sudo smbpasswd -a [password] 
Then restart it with: 
sudo /etc/init.d/samba restart 


And yow’re done! 
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PLEX ON PI 


Plex is a great piece of 
software for creating a 
media server as it also 
includes some interesting 
online stream options for 
your media. Setting it up on 
Pi is not much more difficult 
than the simple setup we 
have here - check out this 
great tutorial on how to do it: 
magpi.cc/2mipsGA. 


CREATE A 


STREAMER 


YOU'LL NEED 


Raspberry Pi 3 is best due to its 
built-in wireless LAN and easy 
audio options 


Pi MusicBox is the perfect OS for 
streaming music online and from 


your media servers 


OTHER HARDWARE: 


You can either use one that connects 
via the Pi'’s headphone socket 

(eg. ) or geta 
Bluetooth speaker 


Much easier to carry around 


If you move around a Lot, this will 


make carrying it easier 


usic is the soundtrack of 

our lives,” said famed 

American music-man 
Dick Clark. When you think about 
it, well, of course it is, but it’s 
nice to have a well-known phrase 
to back it up. While some people 
might still listen to the radio, 
DJs much like the late Mr Clark 
decide on the music for you. With 
a Raspberry Pi, you can create 
your own custom radio that plays 
the music you want to listen all 
the time. 


Browse 


Local media 
© Tunein 

4 Scena FM 
OSpotity 
Podcasts 


# Dirble 


Don't Panic 
Centenary 


This is a simple setup really: 
Raspberry Pi 3 in its case with the 
speaker attached to it. You can Blu- 
Tack it to the top of the case if you 
want a quick and dirty way of carrying 
it around the house with you, along 
with a portable mobile battery. 


Head to and 
download the SD card image. You’ ll 
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need to manually install it using 
Etcher, and we have a tutorial on 
that here: : 
Once that’s done, you need to 
do some configuring of the files 
on the SD card before plugging it 
into your Raspberry Pi. First of all, 
navigate to the folder on the 
SD card and open the 

file. From there, look for the 
Network Settings section and add 
the name of your wireless network 
along with the password. 


Plug the SD card into your music 
Pi and turn it on. Give ita moment 
to boot up and then access it ona 
browser on your PC or smartphone 
by heading to ? 
Here you can access the play 
controls, which are very wide- 
ranging. It will accept web streams, 
AirPlay, and even lets you set 
something to automatically start 
playing when you turn it on. 
You’ll need to manually add the 
Samba share you created on your 
file server (something like 
depending on 
how you named your file server Pi). 


You can connect online services 
to your music box by heading to 
the settings menu and scrolling 
down to the services menu. These 
will guide you through how to set 
up Spotify, SoundCloud, Google 
Music, and more. You can even 


connect to podcast streams as well. 


For some services, you’!l need to 
have a paid account, though. 

Once set up, you’ ll find them 
in the Browse menu on the main 
interface and play what you want 
from there. Got a nice Synth Wave 
playlist on Spotify? No problem. 
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PIRATE RADIO — 
A BETTER MUSIC CASE 


The Raspberry Pi has been out for many years, but 
there aren't many cases that include a speaker — 
believe us, we had another very thorough look while 
writing this article! However, the Pirate Radio from 
Pimoroni comes very close. It’s a bit more limited 
than Pi MusicBox, but it will connect to Spotify. You | 
can find the whole kit here: 


YOU'LL NEED 


RASPBERRY PI: 

A Raspberry Pi Zero W is well suited 
for this, as it can be easily hidden 
behind your TV 


OPERATING SYSTEM: 
LibreELEC is our favourite way 
of using Kodi on Pi 


OTHER HARDWARE: 


UNIVERSAL REMOTE 

AND IR RECEIVER 

Although you can easily control 
Kodi via your smartphone 


ADAPTER CABLES (OPTIONAL) 
If you're using the Pi Zero W, 
you might need these 


Connect a Pi to your TV and play videos, music, 


and even show photos on your big screen 


h Kodi. It’s one of our 
favourite pieces of 


software, and has been 
paired with the Raspberry Pi to 
create wonderful media PCs since 
the Pi came out. You can get it in 
various flavours these days, even 
some Pi-specific ones, but we like 
the standard version. Here’s how 


to set it up on your TV. 


Movies / Title 


Kung Fury 


>STEP-01 

Hook it up 

Placement is important. With 

a Pi Zero W you can hide it behind 
your TV easily, but you still need 
to at least power it and connect 

it to your TV. If your TV has a USB 
port, you can always try powering 
the Pi Zero W via it; however, 

it may not supply enough power 


and you’d have to make sure to 
do a software shutdown of the 

Pi before turning the telly off. 
Otherwise we recommend an 
official Pi power supply and also 
to invest in a mini HDMI to HDMI 
cable to cut down on adapters. If 
you plan to use your smartphone 
as aremote, you won’t need 

a USB adapter. 


>STEP-02 

Prepare an SD card 

Freshly format a microSD card. 
If you’re not super-confident 
in using Etcher to burn your 

SD card, put NOOBS on there 
(magpi.cc/2bnf5XF) and install 
LibreELEC from the menu. 
Otherwise, head to the LibreELEC 
website and download the 
latest image for your Raspberry 
Pi (libreelec.tv/downloads). 
Follow our instructions on how 
to burn an SD card with Etcher 


(magpi.cc/2fZkyJD) and then plug 


it into your Pi. 


>STEP-03 

Configure Kodi 

LibreELEC will boot up and 

after doing its own little quick 
configuration, it will then start 
and let you put in your details. 
For this first step, it can be useful 
to plug a keyboard into your Pi, 
however, the on-screen keyboard 
works fine with a remote control. 


Trending Now 
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Watch It Again 


Popular on Netflix 
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Continue Watching for Rob 
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Q |: (Video Rips) 
a Network File System (NFS) 
% Recordings 


@Q Ss: (WDAV-TY) 

Sa UPnP devices 

@ Video playlists 

@ WwW: (WD Elernemts 500) 
Ss Windows network (SMB) 


SS Zeroconf browser 


If youre not super-confident 
in using Etcher to burn your 
SD card, put NOOBS on there 


Connect to the WiFi, set your 
other preferences, and you’re 
ready to go. Quick and easy. 


>STEP-04 

Add a Samba share 

You can add a Samba share from 
your media server in Kodi pretty 
easily. Go down to Videos at the 
bottom of the main Kodi interface 
and select Files. Click on ‘Add 


e 
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OK 


Cancel 


videos’ and then go to Browse. 
Scroll down the choice list to 
‘Windows network (SMB)’ and 
open it. It should show a list of 
available shares, including your 
media server’s shared folder. If 
not, go to ‘Add network location’ 
and manually add your media 
server Pi’s network IP address to 
connect it. Press OK, and you’1l be 
able to access it! 


Q a: @ fl- 
pore d pancens 
VIDEO 
STREAMING 


At the moment, Kodi does 

not support video streaming 
services such as Netflix. It's 
generally a whole lot better 
than your average smart TV is 
at playing video files, though, so 
pairing a Kodi box with a TV that 
can play Netflix itself will give 
you the best of both worlds. 
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YOU'LL NEED 


RASPBERRY PI: 

You'll need a full-sized Raspberry Pi 
for this. You could even use an old 
Model A you have lying around! 


OPERATING SYSTEM: 
LibreELEC. The media player 
software from our HTPC? Yup! 


OTHER HARDWARE: 


RASPBERRY PI SCREEN 

A bigger one, say 7-inch, so the 
photos look nice. The official 
screen is a good fit for this: 
magpi.cc/2mftBGX 


STAND/CASE 

The good thing about the official 
screen is that there are plenty of 
cases for it: magpi.cc/2meas8n 


Step into the future with this high-tech photo frame 


ne of those classic 
science-fiction 
inventions, like video chat 


and communicator watches, live 
photo frames that scroll through 
photos and play video clips have 
existed in the minds of authors for 
a long time. Live frames have been 
around to buy for many years now, 
but with the Raspberry Pi you can 
make an even better version that’s 
much cheaper. 


>STEP-0O1 

Another Kodi box 

Follow our instructions on the 
previous pages on how to install 
Kodi on a Raspberry Pi. Don’t 
plug it into your Pi yet to do the 
setup, though. 

While the SD card is burning, 
make sure your Share folder on 
your file server Pi has a specific 
folder for photos, or even one 
especially created for the photo 


frame. Get the photos and such 
copied into there that you want 
display on the screen. 


>STEP-02 

Frame setup 

If you want to do some fancy 
woodworking to create a more 
traditional frame, now is your 
chance. We’ll assume you know 
what you’ re doing there, so good 
luck, don’t cut yourself. For 
everyone else, connect up your 
screen to the Pi and install them 
both in the case. Find a place 
where you want to keep the live 
photo frame; as usual, you’ ll need 
there to be a power socket nearby 
so you can turn it on. Once you’ve 
got your spot, insert the SD card 
and turn it on. 


>STEP-03 


A new configuration 


You may need to plug in a keyboard 


for this part. Do the Kodi setup 
as usual, making sure to callita 
different name to your other Kodi 
box and other network-connected 
Pis on your network. 

To make it act as a photo frame, 
we need to do two things. First of 


all, similar to how we added a video 


repository folder in the previous 
tutorial, we need to add a photo 
repository to the photo section. 
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This should be the specific folder 
we created in step 2. You can very 
simply start a slideshow from here 
once the pictures are added, but 
let’s go a step further and make it 
do it automatically on boot. 


>STEP-04 

Screensaver 

The trick to this project is using 
one of the Kodi add-ons, called 
Multi Slideshow Screensaver. 

To install it, go to Add-ons > 
Download > ‘Look and feel’, and 
find the Screensaver option. From 
there, you’ll see Multi Slideshow 
Screensaver. You can then edit the 
configuration of the screensaver 
to come on quickly, and to use the 
source folder we created in step 2 
and added in step 3. 


PHOTO STREAMING | 


Not everyone keeps images on a computer or hard 
drive any more, especially with both Apple and 
Google having their own highly integrated cloud 
photo services these days. Some people have made 3S: 
their own photo frames that stream from these | 
services - check out one of these methods here: 
magpi.cc/2mhwJSI 


Now you can turn off your 
photo frame and easily get it back 
to displaying pictures with just 
the flick of a switch! You could 
also then use the touchscreen 
functionality to watch some video 
with it in the kitchen — it’s your 
choice (but you should definitely 
do that). 
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ooo @® lexa is great. While you 
can buy an Alexa device 
outright, wouldn’t it be 

fun if you could build your own? 

Well, you can, as Alexa is available 

for Raspberry Pi, meaning you can 

install a little Alexa device into a 

robot with a Pi Zero W, or control 


YOU'LL NEED your home with a custom AlexaPi. 


Let’s do the latter. 
We recommend a Raspberry Pi 3, we 


as you'll need the wireless LAN, 
headphone jack, and USB ports 


Raspbian, although we'll modify 
it to be AlexaPi 


OTHER HARDWARE: 
So we can talk to Alexa 


So we can hear her response. 
Use one like in the music box 


Get a fresh install of Raspbian on 
an SD card and connect your Pi up 
to monitor, keyboard, and mouse. 
Make sure to attach the speaker 
and microphone as well. Boot it up 
to get the first-time configuration 
out of the way and connect to the 
WiFi. Once you’re ready, open up 


the Terminal and find out your Pi’s 
network IP using . It should 
look something like 192.168.1.25 

— make a note of it and move back 
to a regular computer. 


You need to get some extra 
info to set up your Alexa. Go to 

: ) log 
in, and go to Alexa > Your Alexa 
dashboards > ALEXA > Alexa Voice 
Service. Once there, you’ll see 
‘Register a Product Type’ — from 
there, click on Device. 

Under the Device Type Info 
tab, give your device a name in 
the Device Type ID and Display 
Name fields. Click Next to get 
to Security Profile and, from the 
drop-down menu, choose ‘Create 
a new profile’. Fill out name and 
description however you wish and 
click Next again. 

Under Web, you want to add 
the following... 


Allowed Origins: 
and 


Allowed Return URLs: 
and 


Finally, back at the Devices 
pages, click Manage next to your 
new device and go to Capabilities. 
Enable timers and change the Cards 
option to ‘Cards with text only’. 
Click Update. You’re ready. 


Go back to your Raspberry Pi and 
open up the Terminal again (or SSH 
in if you prefer). Move to the 

folder with: 


Install git with the following so 
we can get the AlexaPi files: 


The AlexaPi files can easily 
be downloaded now using 
the command: 


Finally, run the setup script and 
follow the instructions with: 


Once the setup is complete, turn off 
your Pi and disconnect the monitor, 
keyboard, mouse, and anything else 
you don’t need for Alexa. Place it 

in its new home and give it a test 
run — you may need to edit some of 
the config files to your liking. Once 
it’s working how you want it to, you 
can start customising it and adding 
your own custom commands and 
functions. Perhaps you can get it to 
control all your new media devices 
— the choice is yours! 


Want to do advanced 
configuration? Check out 
the documents for AlexaPi 
on its GitHub page here: 
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Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 
Free Pi Zero W case with three covers 


Free Camera Module connector 
Free USB and HDMI converter cables 
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Other benefits: 

Save up to 25% on the price 

Free delivery to your door 
Exclusive Pi offers and discounts 
Get every issue first (before stores) 
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3D 
ROBOT 


This version of a much-loved classic arcade game 
brings the past to life like never before 


>» The play board 
is 4m? in size 


» Each robot 
measures 
gcm tall 


» Three fathers, 
four sons, and 
an uncle made 
the project 


» Soldering 
many tiny SMD 
components 
proved tricky 


» Find a copy of 
Pac-Man Vs, to 
try it yourself 


hen video games began to 

flourish in the seventies 

and eighties, 15-year-old 
Emanuele Coletta had not even 
been born. But when he and his 
pals caught up with the titles 
they had missed thanks to their 
parents’ collective love of retro 
gaming, they were soon champing 
at the bit to produce something of 
their own. 

The result was a ‘real-life’ 
version of Pac-Man, Namco’s 
classic 1980 pellet-guzzling arcade 
game. They created 3D-printed 
robot renditions of the main 


FE 


character and the familiar four 
ghosts and they replaced the Pac- 
Dots of the original game’s maze 
with lights that turn off when the 


yellow chomper moves over them. 


“The idea was to make 
something funny that no one 
had made before to let us learn 
and apply new technologies,” 
explains Emanuele. But at the 
same time, they added their 
own little twist. 

In the single-player video 
game, Pac-Man has to eat up all 
of the Pac-Dots and avoid the 
ghosts, each of which moves 


PAC ROBOT MAN 


A magnet beneath the main 
character interacts with reed 
switches as it passes over them 


LEDs act as Pac-Dots, turning off 
when the reed switches indicate 
they've been ‘gobbled’ 


automatically. In what became 
3D Pac Robot Man, however, 
four players control the ghosts. 
“The aim is for the main 
character to escape from the 
others without getting caught, 
but for the others to try and catch 
it,” says Emanuele. Suddenly 
their Pac-Man game became 
a five-player romp. 
Initially, the friends — along 
with their dads — concentrated on 
making the playing board out of 
wood, laser-cutting the various 
pieces to form the maze. They 
then attached lots of small boards 


A Pi makes sense of the incoming 
data, monitors the game, and 
allows the score to be displayed 


BRINGING PAC-MAN TO LIFE 


1UP HIGH SCORE 
oo oo 
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>STEP-0O1 


containing LEDs and reed switches 
beneath the gaming field and 
connected them to an Arduino 
Mini. “Assembling the LED boards 
— which we made ourselves — and 
connecting them with bigger 
boards underneath the field was 
the easiest but longest part,” 
Emanuele recalls. 

With that in place, they could 
turn their attention to the 
characters — the shells and bases 
of which were designed by the 
team and 3D printed. Each one 
contains an Arduino Uno board. 
“There is also a magnet under the 
main character,” says Emanuele. 
By connecting the robots to 
3D-printed joysticks containing a 
board created by one of the team 
and an Arduino Nano, they could 
be moved around the maze. “The 
joystick boards communicate 
with the robots through 
radio frequencies at 2.4GHz,” 
Emanuele continues. 

It is at this point that the 
Raspberry Pi comes into play. 
When the main character moves, 
the Arduino Mini understands 
which reed switch is activated 
and it can figure which LED to 
turn off. Points are awarded for 
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>STEP-02 


each light that is ‘eaten’ and this 
information, along with details 
about the game State, is passed 
to the Pi. 

“T wrote a little application in 
Java which allows people to see 
the score, the high score and 
the game state on a monitor,” 
Emanuele tells us, having used 
an open-source library called 
RXTX and the Arduino Playground 
tutorial to establish the serial 
connection between the Arduino 
and Pi. “It also plays the original 
sounds of the game to give the 
whole thing a sense of being real 


3D PAC ROBOT MAN 


Projects 


>STEP-03 


Above The game 
went downa 
storm when it was 
unveiled at Maker 
Faire Rome, held 
between 14 and 16 
October 2017 


and to make people understand 
what we made.” 

It was then a matter of 
encouraging players to get stuck 
in, with the build unveiled 
at Maker Faire Rome. “If the 
main character gets caught, the 
catcher wins, but if the main 
character escapes then it wins.” 
As expected, the game went down 
a storm. “People seemed to like 
our game because they could 
challenge each other,” Emanuele 
enthuses. “It was beautiful to see 
people enjoying their time with 
something we had made.” 
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RED 


Equipped with a Pi brain and several senses, Rosie can even play Countdown 


> OCR is done via 
Google Cloud 
Vision API 


» Alan's Python 
code is on 
his blog 


» Rosie can't 
solve the 
numbers 
round yet 


» She uses two 
Pi 3 brains for 
some tasks 


» Rosie is set 
to havea 
3D-printed 
makeover 


he clock is ticking as the 

contestants concentrate 

hard on finding the 
ongest word possible from nine 
randomly selected letters. Yes, 
it’s Countdown, the classic TV 
game show loved by students, 
senior citizens... and robots. 
Playing along at home is Rosie, 
her Camera Module eye focused 
on the screen. Within seconds 
she blurts out, “I have a six-letter 
answer: murder.” 

Rosie first came to life when 
Alan Peaty was challenged by his 
daughter to build a robot. Despite 
his engineering experience, Alan 
didn’t find it easy. “It didn’t take 
long before I was completely out 
of my comfort zone,” he tells us. 
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“Possibly the most challenging 
aspect of trying to build a robot is 
that there are so many different 
areas of technology involved, from 
hardware to software, mechanics 
to electronics. For example, just 
to get Rosie’s neck to move, we 
had to write some code in Python, 
learn about Serial Peripheral 
Interface bus (SPI), and get 
familiar with servo motors and 
the physics of torque, even before 
thinking about connecting the 
whole thing together. Be prepared 
to Google absolutely everything 
and anything.” 

As documented in detail on the 
rosietheredrobot.com blog, Alan 
has spent several months building 
Rosie and gradually adding extra 


A Pi Camera Module is used 
to read the letters on the TV 


Rosie speaks her answer 
through a mini speaker 


Rosie's expressive face can 
be tilted and rotated 


hardware and abilities, while 
learning a lot along the way. At 
first Rosie was a simple wheeled 
robot, but she is now equipped 
with a headlight, LED matrix 
expressive ‘eyes’, motion sensor, 
GPS receiver, ultrasonic distance 
sensors, and a Camera Module. 


Playing the game 

It’s this last addition that enables 
Rosie to see the Countdown letters 
on the TV screen. Optical character 
recognition is then carried out 
using Google Cloud Vision API, to 
read the letters. “She performs 
relatively well at different 
distances on one condition — 

only the individual letters from 
the letters round is showing 
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on-screen when the photo is 
captured,” reveals Alan. “When 
the contestants’ names, or even 
the channel name, appear in the 
same picture, it starts to muddle 
Rosie’s brain.” 

A Python application runs 
the identified letters through 
an algorithm that matches 
possible results from a dictionary 
containing 10 000 words ~ a dataset 
from magpi.cc/2mgxuv, that 
Alan has arranged alphabetically. 
Python’s gTTS text-to-speech 


e In a bid to become more human, 
Rosie can also identify housefold 
objects and offer instant unfounded 
opinions on them! 


“Tt perhaps goes to show that 
machines are so much better than 
us humans at processing large 
volumes of data rapidly, when 

the requirements of the task are 
crystal clear,” says Alan. “The 
letters round doesn’t really require 
any tactics or strategy, or even 

any complex decision-making. 
You simply need to remember 


It turns out to be a little more 
complicated than just trawling 
through a list of words and letters 


module is then used to get Rosie to 
say the longest word she’s found, 
along with the numbers of letters 
in it, via an on-board speaker. 
Naturally, replacing the 
dictionary with a larger one would 
improve Rosie’s performance, 
but she’s still a decent player. 


> Rosie likes to wrap up warm for 
wintry weather; we're not sure if she 
appreciates red wine 
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every single word in the English 
dictionary and have the ability to 
filter and search through them in 
under 30 seconds.” 

As for getting Rosie to play 
the Countdown numbers game, 
“Weve had a quick look at this,” 
says Alan, “but it turns out to be 
a little more complicated than 
just trawling through a list of 
words and letters. The algorithm 
is likely to need to work out every 
single mathematical operation 
possible not only between the 
chosen numbers, but between the 
results of subsequent operations. 
She would need to add this to 
her repertoire, however, if she 
was ever to appear on the actual 
TV show...” 


> 


Inside Rosie's head 

Rosie's Raspberry Pi 3 brain is contained in the pink 
plastic tub used for her head, along with a camera 
mounted on the lid. Her speech is played through a 
mini USB speaker. 


>STEP-02 

The brainstorm 

Alan planned out how it would work: a photo is 
taken of the letters on TV, OCR identifies them, 
the Python algorithm finds the best word, then it's 


read out via gTTS text-to-speech. 


eo _— 


“>STEP-03 


Play Countdown 

Rosie sits up close to the screen to watch 
Countdown and put Alan's theory into practice. 
Within seconds she speaks the longest word she's 
found in her 10 000-word dictionary. 
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Fuzzy Duck's setup is based 
around a Pi which controls the 
temperature for the hot liquor tank 


The strike temperature of the hot 
liquor tank is adjusted to account 
for the current weather 


» Ben founded 
the Fuzzy 
Duck Brewery 
in 2006 


» He began 
creating his 
Pi controller 
in 2012 


» Ben also 
authored 
the RPi.GPIO 
Python library 


» Irration Ale 
is brewed 
for the Pi 
Birthday Bash 


» The name's a 
pun. Do you 
get it? 


BREWERY 


Fancy a brew? A proper one, that is? Ben Croston uses a Pi 
to control the brewing process at Fuzzy Duck Brewery 


nyone who has ever 
splashed a coffee over an 
uncovered Raspberry Pi 
will be among the first to confirm 
that liquids and electronics don’t 
generally mix very well. But when 
it comes to the harder stuff, Ben 
Croston is proving the two can 
actually go together rather perfectly. 
That’s because Ben is the head 
brewer at the Fuzzy Duck Brewery 
located in Poulton-le-Fylde, 
Lancashire. He makes use of a 
Raspberry Pi controller in the 
brewing process and his beers have 
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become very well known over the 
last few years. 

One of the most popular is 
Irration Ale, which he concocts 
for various Pi bashes. Tasting of 
raspberries, it is so-called because 
piis known as an irrational 
number, but it goes down even 
better knowing the computer is 
involved in its making. 

It all started in late 2011 before 
the first Pi even rolled off the 
production line. Ben, who began 
using Red Hat Linux in 1996 before 
moving to Ubuntu in 2004 and 


then Debian in 2009, wrote what 
became the RPi.GPIO Python 
module, thinking it would become 
useful in the future for controlling 
tasks in the brewery plant. 

“Tt was the equivalent of my 
GCSE IT project in 1994, which was 
a relay switch-box that connected 
to the parallel printer port of a 
PC,” he tells us. “The use of a 
Raspberry Pi in the brewery was 
the natural thing for me to do.” By 
using the RPi.GPIO module anda 
DS18B20 temperature sensor which 
is accurate to within 0.5 degrees 
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Celsius over a range of -10°C to 
85°C, Ben is able to achieve a high 
level of consistency in his brews. 

“The choice of sensors and 
actuators was made more difficult 
due to the physical size of the 
plant and the fact that some parts 
have to be made to a food quality 
standard,” Ben says. Thankfully, 
the rest of the process was 
reasonably straightforward. 

Essentially, the sensor 
connects to a Raspberry Pi before 
being placed in the hot liquor 
tank. Data is then sent down the 
wire to a general-purpose I/O (or 
GPIO) pin. Since Ben’s RPi.GPIO 
allows you to control the pins ona 
Raspberry Pi using the language, 
it is possible to then monitor the 
temperature. Ben does this using 
special-purpose software he 
created himself (the bulk of which 
is closed-source and commercially 
sensitive). Should the brew get too 
hot or cold, the heaters can then 
be adjusted. 

“This is crucial because the key 
to commercial brewing is to be able 


a 
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>STEP-01 
Heat up the water 

With the Raspberry Pi set up and the sensor built 
into the insulated tank, the water can be heated 
up to the required temperature and kept under 


to brew exactly the same beer all 
constant control. 


the time between batches,” Ben 
explains. “This means being able 
to measure, record, and control 
physical attributes while the brew 
is taking place, and it is where 
automating as much as possible 
using a Raspberry Pi makes things 
a lot easier and consistent.” 
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The use of a Raspberry Pi in a 
the brewery was the natural >STEP-02 
thing for me to do 


Mash in the beer 

The mashing process begins. This combines a mix 
of grain with the water (or liquor as it is also known). 
During the heating, the enzymes in the malt break 
down the starch into sugars. 


yw The temperature can be controlled 


via a page that is viewable on a smartphone In order to control the 


temperature, the brewery makes 
use of three methods - an 
electronic control panel, a webpage 
viewable on a smartphone, and 

a PyQt4 GUI application — all of 
which can be used at the same 
time. Fuzzy Duck also uses 
software running on a Pi for its 
invoicing and cask tracking. 


iT} 


= A 
Hot Liquor Tank 


Refresh 


Current Temperature = 73.5°C 
Current Mode = STRIKE 73.5°C 


Heater is OFF 
off That software was written using 
On Python 2.4 in 2007, well before the 
* Strike 73.5 Oa, 
Sparge 778 Pi’s birth, however. 
: = i TT I 
= So has the Pi saved Ben lots of 


>STEP-03 

Drink and relax 

The malt sugar solution is boiled with hops, cooled, 
and yeast is added. Fermentation begins, releasing 
alcohol. Here, Irration Ale is produced - not too sweet 
or bitter and not excessively raspberry flavoured. 


money? “I don’t have a clue,” he 
says. “I’ve never looked at buying 
any commercial brewery control 
equipment. It is much more fun 
to make things yourself and it’s 
certainly easier to customise 

and maintain.” 
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oipnie yjod 


Matt used some speakers 
he already owned. The 
JustBoom Amp HAT gets 
the best out of them 


The new steampunk jukebox 
is contained within a specially 
built plywood box 


ae" " MM qi 


A Pi 3 is placed within 
this main electronics 
assembly. The only 
control is the power 
button beneath 

the voltmeter 


Quick 


» Matt estimates 
the build could 
cost about £135 


» He spenta 
weekend 
prototyping the 
electronics 


» The volume is 
controlled via a 
smartphone 


» Matt wants 
toadda 
volume control 
on the unit 


» Originally the 
build was going 
to feature 


ascreen 


STEAMPUN 


Matt Van Gastel’s retro-futuristic music 
steaming device looks as good as it sounds 


s technology has 

progressed, so too has 

the way that we listen 
to music. We have enjoyed our 
tunes on vinyl, cassette, CD, and 
even MiniDisc, among a plethora 
of formats. We’ve also used MP3 
players and iPods and grown 
accustomed to music streaming. 

Yet one method of listening to 

our favourite songs has remained 
strong throughout this time: the 
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humble radio, a device that for 
many conjures images of cosy 
nights in twiddling AM and FM 
dials to discover new tunes. 

So when we heard that Matt 
Van Gastel had turned the main 
assembly of a 1930s Westinghouse 
radio receiver into a Pi-powered 
modern player, it was music to 
our nostalgic ears. “I’d been 
carrying this old radio from house 
to house for years, fully intending 


to restore it,” he says of the set 
which his great-grandparents had 
bought close to a century ago. “But 
after doing some research and 
determining that there was no real 
value in restoring it, | came up with 
the idea of using a Raspberry Pi to 
create a music server.” 

Matt, who has a background in 
radio and television, began the 
project by tearing out the innards 
from the old tube amplifier. “This 
wasn’t difficult, but it was very 
messy and time-consuming,” he 
says. It mostly involved cutting 
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away the various parts including the 
main electronics assembly. Once he 
had the assembly, he could turn his 
attention to his Raspberry Pi 3. 

“The Pi 3 seemed like a natural 
choice because I already had a few 
of them waiting for a project,” he 
explains. During his research, he 
came across the JustBoom Amp 
HAT which costs £60 and outputs 
at 55 W. Needing no soldering or 


The unit is primarily for show and 
Matt went to town on the design, adding 
these cool simulated vacuum tubes 


local disk or through streaming 
services such as Google Play Music, 
Spotify, and SoundCloud. 

“Mopidy was not my first choice, 
but I was unable to get the Pi Music 
Box to integrate with Google,” 
Matt recalls, citing his music 
service of choice. “Fortunately, 


It's the aesthetics that 
people notice first 


external sound cards, and providing 
high-quality audio along with 
digital-to-analogue conversion, 
Matt felt it was perfect. 


Serving music 
“T had looked at making an actual 
tube amplifier, but the cost was 
too high for the quality,” Matt 
tells us. “But I found the JustBoom 
site and found this HAT fitted the 
bill because of its power output 
capabilities and extremely low noise 
floor and supply requirements.” 
With this in place, Matt then 
looked for flexible music server 
software and opted for Mopidy, 
which is written in Python and 
allows music to be played from a 


The main assembly was stripped 
of its previous components. Matt was 
worried it could have contained asbestos. 
Luckily, it did not 
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Mopidy worked very well for what 

I was trying to do. I was able to use 
Google Music and I found several 
apps for running Mopidy headless.’ 


> 


Powering up 

Matt prepared the case by washing 
and painting it. He then drilled 
holes in the original vacuum 
tubes and wired in amber LEDs to 
give a glowing, steampunk effect 
(“that’s my favourite part,” he 
says). As a neat touch, he wired 
in a voltage monitor using a 1950s 
DC voltmeter and placed an LED 
light behind it. The voltage meter 
jumps when the unit is turned on. 
“People comment on the way the 
needle bounces on the voltmeter 
upon power-up,” he says. 

The build uses power froma 24V 
DC brick running at 2.5A and it 
makes use of a pair of bookshelf 
speakers Matt says sound great 
because of the DAC converter in 
the JustBoom Amp HAT. “But it’s 
the aesthetics that people notice 
first because the unit lives ona 
shelf in my kitchen. I’ve had lots of 
positive feedback.” 
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Start using the mathematics programming language that comes free with Raspbian 


WOLFRAM 


RASPBERRY PI 101: BEGINNER'S GUIDE TO WOLFRAM 


If you’d rather get a number 
outputted as a decimal, the easiest 
way is to add a decimal point to one 
of the numbers in the rational. 


2* 1./5 
0.4 


Alternatively, you can surround 
it in an N function. 


N[1/3] 
CREEEEEE! 


By default, N returns numbers 
to six-digit precision. A second 
value in N can be used to adjust 
the precision: 


N[1/3, 10] 
@.3333333333 


You can convert numbers 

to a nearby rational with the 
smallest denominator using the 
Rationalize function 


Rationalize[@.5] 


1 


2 


Lists 


Now that you’ve got the hang of 
basic mathematical functions, you 
can start to use Wolfram Language 
as a programming tool. 

Lists form a central part of 
Wolfram Language and can 

be used to group together 

items. Lists are placed between 
curly braces {} and can be 

created manually: 


{1, 3, 5} 
Or by using the List function: 


List[1,3,5] 
lily op Ey 


And you can generate lists using 
the Range command: 


Range[5] 
{1, 2, 3, 4, 5} 


Use two numbers to provide 
a start and stop point: 


Range[5,10] 
{5, 6, 7, 8, 9, 10} 


And three numbers to use a start, 
stop, and step: 


Range[2,8,2] 
{2, 4, 6, 8} 


Visualisation 
and export 
Wolfram Language has a host of 
tools for visualising data. Plot is 
a common one used to plot the 
output of functions. Generally it’s 
best to switch to Mathematica if 
you want to get a visual view of 
your function, but it is possible 
to export graphics from the 
command line to an image using 
the Export function. 

Take the Plot function which 
graphs the Sin function of x against 
a list of x values from -Pi to Pi. 


Plot[Sin[x],{x, -Pi, Pi}] 


In Mathematica you’ll get a 
lovely visualisation, while in 
Wolfram Language you just get: 


-Graphics- 


Surround the function in an 
Export function with the first 
value a file name and the second 
the function: 


Export["sinx. jpg", 
Plot[Sin[x],{x, -Pi, Pi}]] 


It will be saved in your /home/pi 
directory by default. To view the 
graph, open a Terminal and enter: 


xdg-open sinx. jpg 


Create functions 

You can create your own functions 
inside Wolfram by entering a name 
for your function with square 
brackets. Then placing a variable 


placeholder, which is a letter 
followed by an underscore, such as 
x_, inside the brackets: 


addtwo[x_] 


User-generated functions are 
lower-case by convention. The 
name is followed by a colon and 
equals sign: 


addtwo[x_]:= 


After the equals sign we add the 
expression, which uses the same 
variable without the underscore: 


addtwo[x_]:=Plus[x,2] 


To use the function, we simply 
use its name and add variables 
into the brackets (as we would any 
regular function). 


addtwo[2] 
4 


addtwo[4] 
6 


With all of these features and 
functions, and the ability to work 
with integers, rational, and real 
numbers (plus a wide range of other 
numbers), Wolfram Language is a 
powerful tool. We’ve only scratched 
the surface of what you can do with 
it here, and it is packed with Boolean 
operators and procedural processes 
(such as for and while loops). 

But hopefully you’ve got enough 
here to find Wolfram Language 
less daunting. Visit reference. 
wolfram.com for the online 
documentation. Be sure to use 
Wolfram Language next time 
you’re working with maths. 


Documentation 


reference.wolfram.com 
/\anguage 
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Tutorial 


> USB to MIDI 
interface cable 


> MIDI sound 
generator 


Create fractals and change them into intriguing music patterns 


ractals seem to have 

gone out of favour when 

it comes to computers, 
which is a pity because there are 
plenty of exciting things to explore 
with them, especially in the field 
of music. Most people think of a 
fractal as a complex curve and there 
a few pleasant-looking standard 
examples. The basic property of a 
fractal is that it is self-similar, that 
is, you see the same sort of pattern 
if looking at a very small magnified 
portion of the curve as you do 
when you look at a zoomed out 
portion. They are both similar, but 


This is the MIDI sound box 
- the name on top might 
have given it away 


not of course identical. Music has 

a similar structure, with patterns 

of notes repeating but developing 
throughout the composition. This is 
a rich, and largely untapped, source 
of tunes and inspiration. 


Fractal generation 

There are many ways to generate 
fractals, but here we will be looking 
at one method, the Lindenmayer 
system, or L-system for short. 

This is a recursive algorithm 
inspired by biological system, it 
works by successive applications 

of substitution rules to a string 


This is the MIDI USB converter 
lead that connects the sound 
box to the Pi 


of symbols to generate another, 
normally longer, string of symbols. 
This output string is fed into the 
input again and a new String is 
generated. This process is repeated 
any number of times and produces 
fractal, or self-similar, sequence. 
The rules and the initial string, 
called the axiom, determine 

the outcome. 

Let’s see how this works in 
practice by looking at a very 
simple example shown in Figure 1. 
This has just three symbols — 

A, B, and C - and each symbol 
has a rule for substitution. So 
when we encounter an A in the 
input stream, we replace it with 
the symbols BA in the output 
stream. When B is encountered, 
we replace it with aC. When C is 
found, we replace it with an AB. 
These rules are shown on the left 
of the diagram. 

If we start with the simple axiom 
of C after the first application of 
the rules, we get the string AB. 
Then run it through the rules again 
and the first symbol A is replaced 
by BA and the second symbol B 
is replaced by C. This applying of 
rules to an input string to produce 
an output string is known as a level 
of recursion; after four levels, our 
symbol string is ABCBABAC. The 
rules can be arbitrarily changed to 
produce different outcomes and the 
string can involve as many single- 
character symbols as you like. 


fe¥) 


Rules about rules 

While the rules can be arbitrary, 

in order to be successful they need 
to follow some rules themselves. 
First of all, each symbol used must 
have a rule associated with it, and 
that symbol must occur in at least 
one of the results of another rule. 
f this is not observed then some 
symbols will be isolated and never 
appear in the output stream. If 

all the symbol rules map only to 
another symbol, then the output 
stream always remains the same 
length; sometimes you might want 
this, but normally you will want a 
sequence to grow. Once an output 
sequence — or successive sequences 
— has been produced then you 
need another set of rules, called 
production rules, to interpret it 
into, in our case MIDI notes. Let’s 
look at a simple example. 


Simple example 

The code in Simple.py generates 

a sequence of symbols and then 
plays them; this then repeats toa 
given level of recursion. The rules 
are expressed as a list of tuples; 
each tuple has two parts, the input 
condition and the output condition. 
To make things easy to interpret 
for us, we have added the string 
"->" to the end of the input string 
so that the tuple ("A->", "AB") 
means replace the symbol A with 
the symbols AB. This just makes 

it easy for us to spot what a rule is 
doing and to change it. The code 
first opens the MIDI port and prints 
out the rules and axiom. Then these 
rules are applied six times and the 
result of each recursion is added to 
a list called composition. 

Finally, the composition is 
passed to a sonification function 
called sonify. The rules for 
turning the symbols into notes 
here are very simple: each symbol, 
A toG, is turned into a MIDI note 
number representing the notes A 
to G, defined by the notes list, and 
played for a time defined by the 
variable noteDuration. This plays 
each level of recursion with a short 
gap between each. Quitting the 
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EXPLORING FRACTAL MUSIC 


program with CTRL+C will cause 
the program to turn all the MIDI 
notes off before quitting so you 
don’t get any hanging notes. 

The code uses MIDI voice 19, 
the church organ, but you can 
change this to anything. If you 
want to alter this on the fly then 
you can load up the MIDI voice test 
program from The MagPi #63 to run 
at the same time. Just navigate to 
the folder containing it, using a 
Terminal window and type: 


nohup python3 voiceTest.py & 


A multichannel version 
The previous example just played a 
single instrument for a single line. 
In this next example, the last three 
levels of recursion are played at the 
same time on different instruments. 
As each level is of a different length, 
the note on time is adjusted so that 
the playing time as a whole is the 
same for each track. This means 
that the smaller levels of recursion 
have longer notes than the higher 
ones. A lot of the code is the same 
as the first example; so, instead 

of repeating the whole listing, we 
have just printed the changes you 
have to make to Simple.py in 
New_Functions_for_Simple.py. 
These changes are basically a new 
sonify function along with two 
additional functions, notFinished 
and playNext. The instruments 
and volume levels are set at the 
start of the sonify function, and 
we have used the ‘rain’ instrument 
for the long notes because it has 
something interesting going on in 
the background for held notes. Short 
notes, we think, are best when the 
sound itself is short, like a bell. 


Adding graphics 

To add some graphics requires 

a much longer program and our 
normal Pygame framework. We 
have written one that will produce 
the sound of the last example, 
only play it back by building up 
the composition by adding one 
track at a time. The screen output 
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is shown in Figure 2 and the 

code can be found in our GitHub 
repository. It might not look like a 
classic fractal, but that is because 
of the very simple mapping of 

the sonification: one symbol 
represents one note. To get a bit 
more flexibility, we need to add 

a different sort of rules: that of 
interpreting the fractal string. 


Interpretation rules 
Interpretation rules are somewhat 
different to the rules we used before 
to produce a symbol string. They 
are not a sequence of substitutions 
but a set of things to do for when 
sonifying each symbol. For example, 
suppose we add some symbols 

in the production rules to alter 

the length of a note. When this 
symbol occurs, the note duration 
changes but no note is generated 

for that symbol; that means we 
can’t use the trick of altering the 
note length based on the length of 
the sequence. It’s easy enough to 
do this, however, and it adds a bit 
of variety to the composition. The 
extra code to add this feature is in 
Extra_Code_for_Note_Duration_ 
Functions.py and it shows what you 
have to change to the Simple.py 
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Tutorial 


Figure 2 Adding 
graphics to the 
sound output 


Rules for fractals in 
Inkscape'’s L-system 


WALKTHROUGH 


Axiom AD 


het 
code: it is just a replacement for the 
sonify function and a new axiom 
string and rules list. Here there are 
three lengths of note defined by 
the symbols q, h, and c, and these 
change the duration variable for 
subsequent notes. 


Adding a state machine 
These interpretation rules are still 
direct substitutions of notes and 
length of notes. To get another 
level of complexity you have to get 
these symbols to interact with a 
state machine, and use the latter 
to define various parameters of the 
music. When this system is used 
for producing fractal drawings, 


Figure 3 


Ruler 
[Ao AB), (Be', BC), (Co', ED), (De, AF), (Eo, FG) (Fe, 8), (Go, DY 


UL Hoary 
that state machine is a turtle 
graphics drawing package. Symbols 
represent turtle commands like 
move forward, turn left or right 

a specific angle, or move without 
drawing, to name but four. It is the 
cumulative result of these sorts of 
commands that determines what 

is drawn at any one time. In order 
to get separate branches, there 

are two other types of operation 
represented by symbols: the [ 
which places the turtle state ona 
stack, and the ] which restores the 
turtle state from a stack. You can 
have a look at such a system if you 
install a graphics program called 
Inkscape. When you run it, go to the 


Extensions menu, select Render, 
then the L-system option. You will 
get a window that allows you to set 
rules and turn angles; you can set 
more than one rule by separating 
them with a semicolon. Figure 3 
shows a list of rules for fractals to 
set you off exploring. 


BUSH 
Axiom: ++F 


Rules: F=FF-[-F+F+F]+[+F-F-F] 


DRAGON CURVE 


Axiom: FX 


Rules: X=X+YF; In the same way, you can 
Y=FX-Y; implement a music turtle that 

Angle: 90 determines the frequency, duration, 
and any effects you care to specify. 

KOCH ISLAND. So the range of notes is much wider 

Axiom: -F--F--F than you can get from a one-to-one 

Rules: F=F+F--F+F; mapping of symbol to note. This 

Angle: 60 musical turtle can be restrained to 


a certain range of parameters by 
wrapping round the values as they 
exceed their limits. The code for this 


OTHER FRACTAL 


Axiom: W 


Rules: W=+++X--F--ZFX+; is shown in Classic_Fractals.py and 
X=---W++F++YFW- ; although it looks similar to the other 
Y=+ZFX--F--Z+++3 listings, it does have many slight 
Z=-YFW++F++Y --- 3 changes. Fora start, the production 

Angle: 30 tules have been changed to reflect 

the Inkscape system: where there 

PENROSE P3 is no rule for a symbol, that symbol 

Axiom:  [N]++[N]++[N]++[N]++[N] is just copied to the output string. 

Rules: M=OA++pA----NA[-OA----MA]++; Also, the production rules match: 
N=+0A- -PA[ ---MA--NA]+; any symbol A to F plays a note 
O=-MA++NA[+++0A++PA] - ; and updates the pitch, whereas 
P=--OA++++MA[+PA++++NA ] --NA; any symbol G to L just updates the 

Angle: 36 pitch. Note the initKey function; 
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this generates a lookup table in 

any major key determined by the 
starting note. The rules in the listing 
are for a bush whose graphical 
representation is shown in Figure 4. 


Results 

Well, what does all this sound 
like? The uncharitable might say 
it sounds like a maniac practising 
scales, but there is a lot more to 

it than that. We liked the simpler 
systems best, as we felt there was 
a tune trying to break out and 
occasionally succeeding; you could 
definitely hear the self-similarity 
coming through. Small changes in 
rules produced small changes in 
melodies, which is good for control, 
and we liked the multitimbral 
approach of having more than one 
track playing at the same time. 


Taking it further 

Like no other project, this is one 
you just have to tinker with. You 
can have a lot of fun making up 
tules and listening to the results. 
This just requires typing them in at 
the start of the program. There are 
lots of variations you can make to 
the production rules, like including 
a probability factor to some. For 
example, you can have two rules for 
one symbol, and attach a probability 
that one rule will be used over 
another simply by generating a 
number from one to ten, and if the 
number is above some value then 
use rule one, otherwise use rule two. 
The production rules for the state 
machine can be changed to include 
note duration or even note timbre. 
For serious music it is probably best 
to pick out the good bits in a fractal 
sequence and incorporate that into 
your own music. 


Figure 4 A fractal bush 
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EXPLORING FRACTAL MUSIC 


Classic_fractals see AM) toys San et 
— ik Py @59. duration = noteDuration # 


start with same note length >PYTHON 3 


601. import time, copy 


; aie 060. notePlay = len(notes) / 2 
a SIEGES ACLINGES # and same start note ace aie 
08: 061. noteIncrement = 1 # and oe bis 
004. midiout = rtmidi.MidiOut() Sanemnoronincrenant PROJECT 
eo 062. stack = [] # clear stack VIDEOS 
006. noteDuration = 0.3 063 print("") 
O07 e64. if j==0: Check out Mike's 
008. axiom = "++F" # Bush print ("Axiom Bakery videos at: 


ee9. rules = [("F->","FF-[-F+F+F]+[+F-F-F]")] 


magpi.cc/1NqJnTz 


e65. ",j,data[j]) 


ete: 066. else: 
Q11. — newAxiom = axiom 067. print("Recursion ",j,data[j]) 
eras 068. for i in range(@,len(data[j])): 
@13. def main(): 069. symbol = ord(data[j][i:i+1]) 
Oe global newAxiom 070. if symbol >= ord('A') and symbol <= ord('F') : # 
615. init() # open MIDI port play current note 
016. of FMIDI() e71. #print(" playing",notePlay) 
e17. initkey() @72. note = notes[int(notePlay) ] 
018. print("Rules :-") @73. #print("note", note, "note 
19. print (rules) increment",noteIncrement ) 
020. print("Axiom :-") 074. midiout.send_message([@x8@ | @,lastNote,68]) # 
@21. print (axiom) last note off 
22. composition = [newAxiom] 75. midiout.send_message([@x90 | @,note,68]) # 
@23. for r in range(@,4): # change for deeper levels next note on 
24. newAxiom = applyRules(newAxiom) e76. lastNote = note 
625. composition. append (newAxiom) 077. if symbol >= ord('A') and symbol <= ord('L') : # 
@26. sonify (composition) move note 
627. 078. notePlay += noteIncrement 
@28. def applyRulesOrginal(start): @79. if notePlay < @: # wrap round playing note 
629. expand = "" @80. notePlay = len(notes)-1 
030. for i in range(@,len(start)): 081. elif notePlay >= len(notes): 
631. rule = start[i:i+1] +"->" e82. notePlay = 2 
032. for j in range(@,len(rules)): 83. time.sleep(duration) 
@33. if rule == rules[j][®] : @84. if symbol == ord('+'): 
034. expand += rules[j][1] @85. noteIncrement += 1 
@35. return expand @86. if noteIncrement > 6: 
636. 087. noteIncrement = 1 
@37. def applyRules(start): 88. if symbol == ord('-'): 
@38. expand = "" 89. noteIncrement -= 1 
639. for i in range(@,len(start)): e90. if noteIncrement < -6: 
40. symbol = start[i:i+1] e91. noteIncrement = -1 
041. rule = symbol +"->" @92. if symbol == ord('|'): # turn back 
042. found = False e93. noteIncrement = -noteIncrement 
043. for j in range(@,len(rules)): e904. if symbol == ord('['): # push state on stack 
044. e95. stack. append( (duration, notePlay, noteIncreme 
45. if rule == rules[j][9] : nt)) 
046. expand += rules[j][1] 096. #print("pushed", duration, notePlay, noteIncremen 
047. found = True t, "Stack depth", len(stack)) 
048. if not found : @97. if symbol == ord(']'): # pull state from stack 
e49. expand += symbol e98. if len(stack) != 0: 
50. return expand e99. recovered = stack.pop(int(len(stack)-1)) 
@51. 100. duration = recovered[0] 
@52. def sonify(data): # turn data into sound 101. notePlay = recovered[i] 
@53. initMIDI(@,65) # set volume 102. noteIncrement = recovered[2] 
654. noteIncrement = 1 193. #print(“recovered", duration, notePlay,noteIn 
055. notePlay = len(notes) / 2 crement, "Stack depth", len(stack) ) 
@56. midiout.send_message([@xCc@ | @,19]) # voice 19 Church 104. else: 
organ 105. print("stack empty") 
@57. lastNote = 1 106. midiout.send_message([@x8@ | @,lastNote,68]) # last 
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107. note off Se mARE) 
time.sleep(2.0) @11. ("E->","FG"), ("F->","B"),("G->",."D") ] 

108. @12. newAxiom = axiom 
109. def initKey(): 013. 
110. global startNote, endNote, notes @14. def main(): 
alls ie key = [2,1,2,2,1,2] # defines scale type - a Major 015. global newAxiom 

scale 616. init() # open MIDI port 
a26 notes =[] # look up list note number to MIDI note 017. offMIDI() 
113. startNote = 24 # defines the key (this is C ) 018. print("Rules :-") 
114. endNote = 84 19. print(rules) 
lay i = startNote 620. print("Axiom :-") 
116. 2 2 21. print (axiom) 
ali) while i< endNote: @22. composition = [newAxiom] 
118. notes. append(i) 23. for r in range(@,6): 
119. i += key[j] @24. newAxiom = applyRules(newAxiom) 
120. j t=1 25. composition. append(newAxiom) 
121. aap 4) = Gs 26. sonify(composition) 
22) j=90 @27. 
1237 #print(notes) @28. def applyRules(start): 
124. 29. expand = "" 
A255 def init(): 30. for i in range(@,len(start)): 
126. available _ports = midiout.get_ports() 31. rule = start[i:i+1] +"->" 
dea print("MIDI ports available: -") 32. #print("we are looking for rule",rule) 
128. for i in range(@,len(available_ports)): 33. for j in range(@,len(rules)): 
129. print(i,available_ports[i]) 34. if rule == rules[j][@] : 
130. if available_ports: 35. #print("found rule", rules[j] 
ales midiout.open_port(1) [6], "translates to",rules[j][1]) 
132. else: 36. expand += rules[j][1] 
133. midiout.open_virtual_port("My virtual output") 37. return expand 
134. @38. 
135) def initMIDI(ch, vol): @39. def sonify(data): # turn data into sound 
136. midiout.send_message([@xB@ | ch,@x@7,vol]) # set to 040. initMIDI(@,65) # set volume 

volume 041. midiout.send_message([@xCc@ | @,19]) # voice 19 
STs midiout.send_message([@xB@ | ch,@xe@,exee]) # set Church organ 

default bank 042. lastNote = 1 
138. 043. for j in range(@,len(data)): 
alet)s def of fMIDI(): 044. if j==0: 
140. for ch in range(@,16): 045. print("Axiom ",j,data[j]) 
141. midiout.send_message([@xB@ | ch,@x78,@]) # notes @46. else: 

off 047. print("Recursion ",j,data[j]) 
142. 048. for i in range(@,len(data[j])): 
143. # Main program logic: 49. note = notes[ord(data[j][i:i+1]) - ord('A’)] # 
144. if _name_ == '_main_': get note given by letter 
145. try: @50. midiout.send_message([@x8e@ | @,lastNote,68]) # 
146. main() last note off 
147. except: @51. midiout.send_message([@x9@ | @,note,68]) # 
148. of fMIDI() next note on 

@52. lastNote = note 


Si le 053. time.sleep(noteDuration) 
ump Py 054. midiout.send_message([@x8@ | @,lastNote,68]) # 


last note off 


001. import time, random, copy @55. time.sleep(2.@) 

ee2. import rtmidi 056. 

ee3. @57. def init(): 

004. midiout = rtmidi.MidiOut() 058. available _ports = midiout.get_ports() 
065. @59. print("MIDI ports available: -") 

ee6. notes = [57,59,60,62,64,65,67] 60. for i in range(@,len(available_ports)): 
007. noteDuration = 0.3 061. print(i,available_ports[i]) 

008. 062. if available ports: 

ee9. axiom = "AD" 063. midiout.open_port(1) 


e10. rules = ECAaS os AB") <C1B=5"", "BG" ), (oG=> 6 SED”). (4D= e64. else: 
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Q65. 
066. 
067. 
068. 


069. 


e708. 
e71. 
072. 
673. 


074. 
075. 
e76. 
077. 
078. 
079. 
e8e. 


EXPLORING FRACTAL MUSIC 


midiout.open_virtual_port("My virtual output") 


def initMIDI(ch,vol): 

midiout.send_message([@xB@ | ch,@x@7,vol]) # set to 
volume 

midiout.send_message([@xB@ | ch,@xe@,0xe0]) # set 
default bank 


def of fMIDI(): 
for ch in range(@,16): 
midiout.send_message([@xB@ | ch,@x78,0]) # notes 
off 


# Main program logic: 
if __name_ == 
try: 
main() 
except: 
offMIDI() 


New _Tunctions_of Simple.py 


def sonify(data): 
melodyLines = 3 # change for more or less lines 
# for more melody lines add more elements to the next 
two lists 
instruments = [112, @, 96] # instruments for each line 
volume = [50, 60, 65] # volume for ech line 
lastNote = [] 
index = [] 
startTime = [] 
interval = [] 
lineLength = [] 
for i in range(@,melodyLines): 
initMIDI(i, volume[i]) # setu up MIDI channel 
midiout.send_message([@xCc@ | i,instruments[i]]) # 
set voice 
startTime.append(time.time()) # set up lists 
index. append(@) 
lastNote.append(@) 
interval.append(noteDuration * 
len(data[len(data)-1])/len(data[len(data)-1-i])) 
lineLength. append(len(data[len(data)-1-i])) 
print() ; print("Playing") 
for i in range(@,melodyLines): 
print("line",i, "voice",instruments[i], "length", lin 
eLength[i], 
"notes of duration", interval[i], "seconds") 
while notFinished(melodyLines, lineLength, index) : 
for i in range(@,melodyLines): 
if time.time() - startTime[i] > interval[i]: 
lastNote[i] = playNext(i,index[i], lastNote[i] 
» data, len(data)-1) 
index[i] += 1 
startTime[i] = time.time() 
time.sleep(noteDuration) 
for i in range(@,melodyLines): 
midiout.send_message([@x8@ | i,lastNote[i],68]) # 
last note off 
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043. 


044. 


ee1. 
ee2. 


0e3. 


004. 
005. 
006. 
007. 


008. 
ee9. 
010. 


011. 
Q12. 
013. 
14. 
015. 
e16. 
017. 


e18. 


Q19. 


@20. 


e21. 
22. 
Q23. 
24. 
e25. 
@26. 
027. 
28. 
29. 
30. 


31. 


. def notFinished(playingLines,length, point): 


notDone = True 
for i in range(@,playingLines): 
if point[i] >= length[i] : 
notDone = False 


return notDone 


- def playNext(midiChannel, i , lastNote, data, line): 


note = notes[ord(data[line][i:i+1]) - ord('A’)] # get 
note given by letter 

midiout.send_message([@x8@ | midiChannel, lastNote,68]) 
# last note off 

midiout.send_message([@x9@ | midiChannel,note,68]) # 
next note on 

return note 


&xtra_Code or_Note 


_Duration_ Py 


rules = [("A->","ABc"),("B->", "BCh"), ("C->","EDq"), ("D- 
SU ARG.) 

(E+>", "FGh"), (“F->","Bq”), ("G+>","De”),,("q- 
3", "hA"), ("H->"3"GF"),("e->","hE”) 1] 


def sonify(data): # turn data into sound 
initMIDI(@,65) # set volume 
midiout.send_message([@xCc@ | @,19]) # voice 19 Church 
organ 
lastNote = 1 
for j in range(@,len(data)): 


duration = noteDuration # start with same note 
length 
if j==0: 
print( "Axiom ",j,data[j]) 
else: 


print("Recursion ",j,data[j]) 
for i in range(@,len(data[j])): 
symbol = ord(data[j][i:i+1]) 
if symbol >= ord('A’) and symbol <= ord('G') : # 
it is a note 
note = 
given by letter 
midiout.send_message([@x80 | @,lastNote,68]) # 
last note off 
midiout.send_message([@x9@ | @,note,68]) # 
next note on 
lastNote = note 
time.sleep(duration) 


notes[symbol - ord('A')] # get note 


else : # it is a note duration 
if symbol == ord(‘h'): 
duration = noteDuration * 2 
if symbol == ord(‘c'): 
duration = noteDuration 
if symbol == ord(‘q'): 
duration = noteDuration / 2 


midiout.send_message([@x8@ | @,lastNote,68]) # last 
note off 
time.sleep(2.0) 
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WHY RASPBERRY PI 
ISN'T VULNERABLE TO 


SPECTRE on MELTDOWN 


Learn how these complex exploits work with this simple and clear 
explanation, and discover why the Raspberry Pi isn't affected 


Raspberry Pi 
raspberrypi.org 


Thonny IDE 


SPECTRE 
PAPER 


If you want 

to really get 
inside Spectre, 
read the 
paper ‘Spectre 
Attacks: 
Exploiting 
Speculative 
Execution’ 


magpi.cc/ 
2mJEKRo 


ver the last few weeks, there has been a 

lot of discussion about a pair of security 

vulnerabilities nicknamed Spectre and 
Meltdown (spectreattack.com). These affect all 
modern Intel processors, and (in the case of Spectre) 
many AMD processors and ARM cores (developer. 
arm.com/support/security-update). 

Spectre allows an attacker to bypass software checks 
to read data from arbitrary locations in the current 
address space; Meltdown allows an attacker to read 
data from arbitrary locations in the operating system 
kernel’s address space (which should normally be 
inaccessible to user programs). 

Both vulnerabilities exploit performance features 
(caching and speculative execution) common to 
many modern processors to leak data via a so-called 
side-channel attack. Happily, the Raspberry Pi isn’t 
susceptible to these vulnerabilities, because of the 
particular ARM cores that we use. 

To help us understand why, here’s a little primer 
on some concepts in modern processor design. We’ 11 
illustrate these concepts using simple programs in 
Python syntax like this one: 


= atb 
= c+d 
= e+f 
vtg 
= h+i 
= jtk 


< KX = < £& et 
iT} 


While the processor in your computer doesn’t 
execute Python directly, the statements here are 
simple enough that they roughly correspond toa 
single machine instruction. We’re going to gloss over 
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some details. Notably pipelining (magpi.cc/2mg9IV7J) 
and register renaming (magpi.cc/2m9T6cG), which 
are very important to processor designers, but which 
aren’t necessary to understand how Spectre and 
Meltdown work. 

For a comprehensive description of processor 
design, and other aspects of modern computer 
architecture, you can’t do better than Hennessy and 
Patterson’s classic Computer Architecture: A Quantitative 
Approach (magpi.cc/2m9UWEz2). 


What is a scalar processor? 

The simplest sort of modern processor executes one 
instruction per cycle; we call this a scalar processor. 
Our aforementioned example will execute in six cycles 
on a scalar processor. 

Examples of scalar processors include the Intel 

486 and the ARM1176 core used in Raspberry Pi1 and 
Raspberry Pi Zero. 


What is a superscalar processor? 

The obvious way to make a scalar processor (or indeed 
any processor) run faster is to increase its clock 
speed. However, we soon reach limits of how fast the 
logic gates inside the processor can be made to run; 
processor designers therefore began to look for ways 
to do several things at once. 

An in-order superscalar processor examines the 
incoming stream of instructions and tries to execute 
more than one at once, in one of several pipelines 
(pipes for short), subject to dependencies between the 
instructions. Dependencies are important: you might 
think that a two-way superscalar processor could 
just pair up (or dual-issue) the six instructions in our 
example like this: 
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t, u = atb, c+d 
Vv, W = e+f, vtg 
xX, y = hti, jt+k 


But this doesn’t make sense: we have to compute 
v before we can compute w, so the third and fourth 
instructions can’t be executed at the same time. Our 
two-way superscalar processor won’t actually be able 
to find anything to pair with the third instruction, so 
our example will execute in four cycles: 


t, u = atb, c+d 

V = e+f # second pipe does nothing here 
W, X = v+g, hti 

y = jtk 


Examples of superscalar processors include the Intel 
Pentium, and the ARM Cortex-A7 and Cortex-A53 
cores used in Raspberry Pi 2 and Raspberry Pi 3 
respectively. Raspberry Pi 3 has only a 33% higher 
clock speed than Raspberry Pi 2, but has roughly 
double the performance: the extra performance is 


Tutorial 


RASPBERRY 
PI FORUM 


partly a result of Cortex-A53’s ability to dual-issue a 
broader range of instructions than Cortex-A7. 


What is an out-of-order processor? 
Going back to our example, we can see that, although 
we have a dependency between v and w, we have other 
independent instructions later in the program that 
we could potentially have used to fill the empty pipe 
during the second cycle. An out-of-order superscalar 
processor has the ability to shuffle the order of 
incoming instructions (again subject to dependencies) 
in order to keep its pipes busy. 

An out-of-order processor might effectively swap 
the definitions of w and x in our example like this: 


a+b 
c+d 
e+f 
h+i 
v+g 
jtk 


“<= x < £ et 
iT] 


Ci06 


Raspberry Fi 3 Model B V1.2 Ra? 
(© Rospberry Pi 2015 =. 


=" FCC 1D; 2ABCB-RPI32 
IC: 20053-RP132 


The Raspberry Pi 3 shown here uses an ARM Cortex-A53 processor 


(and the older Raspberry Pi 2 uses an ARM Cortex-A7). 


The lack of speculation in the ARM1176, Cortex-A7, and Cortex-A53 
cores used in Raspberry Pi render us immune to attacks of the sort. 
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Acache is a small on-chip memory, close to the processor, which 
stores copies of the contents of recently used locations (and their 
neighbours), so that they are quickly available on subsequent 
accesses. Both Spectre and Meltdown use side-channel attacks 
based on the contents of the cache. 
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meltdown: 
mov al, byte [rcx] 


shl 


rax, @Oxc 


Jz meltdown 
mov rbx, gword [rbx + rax|] 


Above A Meltdown 
code illustration 


AFFECTED 
CPUS 


Most computer 
companies 
have offered 
information 
on how they 
are affected. 
You can see 

a full list of 
statements 
from each 
company at 
bottom of the 
SpectreAttack 
webpage. 


spectreattack. 
com 


...allowing it to execute in three cycles: 


t, u = a+b, c+d 
v, X = etf, hti 
WwW, y = v+g, jtk 


Examples of out-of-order processors include the 
Intel Pentium 2 (and most subsequent Intel and AMD 
x86 processors with the exception of some Atom and 
Quark devices), and many recent ARM cores, including 
Cortex-Ag, -A15, ~A17, and -A57. 


What is branch prediction? 
Our example above is a straight-line piece of code. 
Real programs aren’t like this of course: they also 


Image Credit: SpectreAttack (spectreattack.com) 


statistics about how often particular branches have 
been taken in the past. 

Modern branch predictors are extremely 
sophisticated, and can generate very accurate 
predictions. Raspberry Pi 3’s extra performance is 
partly a result of improvements in branch prediction 
between Cortex-A7 and Cortex-A53. However, by 
executing a crafted series of branches, an attacker can 
mis-train a branch predictor to make poor predictions. 


What is speculation? 

Reordering sequential instructions is a powerful 
way to recover more instruction-level parallelism, 
but as processors become wider (able to triple- or 
quadruple-issue instructions) it becomes harder to 


Here's a little primer on some concepts 


contain both forward branches (used to implement 
conditional operations like if statements), and 
backward branches (used to implement loops). A 
branch may be unconditional (always taken), or 
conditional (taken or not, depending on a computed 
value); it may be direct (explicitly specifying a target 
address) or indirect (taking its target address froma 
register, memory location or the processor stack). 
While fetching instructions, a processor may 
encounter a conditional branch which depends on a 
value which has yet to be computed. To avoid a stall, it 
must guess which instruction to fetch next: the next 
one in memory order (corresponding to an untaken 
branch), or the one at the branch target (corresponding 
to a taken branch). A branch predictor helps the 
processor make an intelligent guess about whether a 
branch will be taken or not. It does this by gathering 
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in modern processor design 


keep all those pipes busy. Modern processors have 
therefore grown the ability to speculate. Speculative 
execution lets us issue instructions which might turn 
out not to be required (because they may be branched 
over): this keeps a pipe busy (use it or lose it!), and if 
it turns out that the instruction isn’t executed, we can 
just throw the result away. 

Speculatively executing unnecessary instructions 
(and the infrastructure required to support speculation 
and reordering) consumes extra energy, but in many 
cases this is considered a worthwhile trade-off to 
obtain extra single-threaded performance. The branch 
predictor is used to choose the most likely path 
through the program, maximising the chance that the 
speculation will pay off. 

To demonstrate the benefits of speculation, let’s 
look at another example: 
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t = atb 

u = t+c 

v = u+d 

if v: 
w = etf 
X = wg 
y = x+th 


Now we have dependencies from t to u to v, and 
from w to x to y, so a two-way out-of-order processor 
without speculation won’t ever be able to fill its 
second pipe. It spends three cycles computing t, u, 
and v, after which it knows whether the body of the if 
statement will execute, in which case it then spends 
three cycles computing w, x, and y. Assuming the 
if (implemented by a branch instruction) takes one 
cycle, our example takes either four cycles (if v turns 
out to be zero) or seven cycles (if v is non-zero). 

If the branch predictor indicates that the body of 
the if statement is likely to execute, speculation 
effectively shuffles the program like this: 


t = atb 

u = t+c 
v = u+d 
W_ = etf 
X_ = wig 
y_ = x_th 
if v: 


W, X, Y=W_s, X_5 Y_ 


So we now have additional instruction level 
parallelism to keep our pipes busy: 


t, w_ = atb, e+f 
u, X_ = ttc, wi+g 
v, y_ = utd, x_th 
if v 


W, X,; Y=W_s X_5 Y_ 


Cycle counting becomes less well defined in 
speculative out-of-order processors, but the 
branch and conditional update of w, x, and y are 
approximately) free, so our example executes in 
approximately) three cycles. 


What is a cache? 


n the good old days, the speed of processors was 
well matched with the speed of memory access. My 
BBC Micro, with its 2 MHz 6502, could execute an 
instruction roughly every 2 ys (microseconds), and 
had a memory cycle time of 0.25 us. Over the ensuing 
35 years, processors have become very much faster, 
but memory only modestly so: a single Cortex-A53 in 
a Raspberry Pi 3 can execute an instruction roughly 
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every 0.5ns (nanoseconds), but can take up to 100ns 
to access main memory. 

At first glance, this sounds like a disaster: every 
time we access memory, we’ll end up waiting for 
100ns to get the result back. 

In this case, this example: 


o 
iT 


mem[Q@] 
mem[1] 


ing 
iT] 


... would take 200ns. 

However, in practice, programs tend to access 
memory in relatively predictable ways, exhibiting 
both temporal locality (if I access a location, I’m likely 
to access it again soon) and spatial locality (if I access 
a location, I’m likely to access a nearby location soon). 
Caching takes advantage of these properties to reduce 
the average cost of access to memory. 

A cache is a small on-chip memory, close to the 
processor, which stores copies of the contents of 
recently used locations (and their neighbours), so that 
they are quickly available on subsequent accesses. 
With caching, the example above will execute ina 
little over 100ns: 


a = mem[@] # 100ns delay, copies 
mem[@:15] into cache 
b = mem[1] # mem[1] is in the cache 


From the point of view of Spectre and Meltdown, 
the important point is that if you can time how longa 
memory access takes, you can determine whether the 
address you accessed was in the cache (short time) or 
not (long time). 


What is a side channel? 
From Wikipedia: 
“.. a Side-channel attack is any attack 
based on information gained from the physical 
implementation of a cryptosystem, rather than brute 
force or theoretical weaknesses in the algorithms 
(compare cryptanalysis). For example, timing 
information, power consumption, electromagnetic 
leaks or even sound can provide an extra source 
of information, which can be exploited to break 
the system.” 
Spectre and Meltdown are side-channel attacks 
which deduce the contents of a memory location 
which should not normally be accessible by using 
timing to observe whether another, accessible, 
location is present in the cache. 


Putting it all together 

Now let’s look at how speculation and caching 
combine to permit a Meltdown-like attack on our 
processor. Consider the following example, which is 
a user program that sometimes reads from an illegal 
(kernel) address, resulting in a fault (crash): 


Tutorial 


Meltdown 
Meltdown 
breaks the most 
fundamental 
isolation 
between user 
applications and 
the operating 
system. This 
attack allows 

a program to 
access the 
memory, and 
thus also the 
secrets, of other 
programs and 
the operating 
system. 


4? 


Spectre 
Spectre breaks 
the isolation 
between 
different 
applications. 

It allows an 
attacker to 
trick error-free 
programs, 
which follow 
best practices, 
into leaking 
their secrets. In 
fact, the safety 
checks of said 
best practices 
actually 
increase the 
attack surface 
and may make 
applications 
more susceptible 
to Spectre. 


Images courtesy 
of Natascha Eibl, 
vividfox.me 
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Image Credit: SpectreAttack (spectreattack.com) 


if (x < array1_size) 
= array2[array1[x] *°256]; 


y 


Above A Spectre code illustration 


ARM 
SECURITY 
UPDATE 


The Raspberry 
Pi runs ARM 
processors, 
and ARM has 

a webpage 
outlining more 
information 

on how its 
products are 
affected. It 
also lists the 
vulnerability of 
its processors 
to the 
speculation 
side-channel 
(Spectre) 
attacks. ARM 
notes that “The 
majority of Arm 
processors are 
not impacted 
by any 
variation of this 
side-channel 
speculation 
mechanism.” 
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t = a+b 
u = t+c 
v = utd 
if v 


w = kern_mem[address] 

# if we get here, fault 
X = w&@x100 
y = user_mem[x] 


Now, provided we can train the branch predictor 
to believe that v is likely to be non-zero, our out-of- 
order two-way superscalar processor shuffles the 
program like this: 


t, w_ = atb, kern_mem[address] 
u, X_ = ttc, w_&0x100 
Vv, y_ = u+d, user_mem[x_] 
if v: 
# fault 


W, X, Y = W_y X_, y_ # we never get here 


Even though the processor always speculatively 
reads from the kernel address, it must defer the 
resulting fault until it knows that v was non-zero. 
On the face of it, this feels safe because either: 


* vis zero, so the result of the illegal read isn’t 
committed to w 


* vis non-zero, but the fault occurs before the 
read is committed to w 


However, suppose we flush our cache before 


executing the code, and arrange a, b, c, andd so that 


v is actually zero. Now, the speculative read in the 
third cycle: 


Vv, y_ = u+d, user_mem[x_] 


...will access either userland address @x@@@ or 
address @x1@@ depending on the eighth bit of the 
result of the illegal read, loading that address and 
its neighbours into the cache. Because v is zero, 
the results of the speculative instructions will be 
discarded, and execution will continue. If we time 
a subsequent access to one of those addresses, 
we can determine which address is in the cache. 
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Congratulations: you’ve just read a single bit from 
the kernel’s address space! 

The real Meltdown exploit is substantially more 
complex than this (notably, to avoid having to mis- 
train the branch predictor, the authors prefer to 
execute the illegal read unconditionally and handle 
the resulting exception), but the principle is the 
same. Spectre uses a similar approach to subvert 
software array bounds checks. 


Conclusion 

Modern processors go to great lengths to preserve 
the abstraction that they are in-order scalar 
machines that access memory directly, while in 
fact using a host of techniques including caching, 
instruction reordering, and speculation to deliver 
much higher performance than a simple processor 
could hope to achieve. Meltdown and Spectre are 
examples of what happens when we reason about 
security in the context of that abstraction, and 
then encounter minor discrepancies between the 
abstraction and reality. 

Fortunately, the lack of speculation in the 
ARM1176, Cortex-A7, and Cortex-A53 cores used 
in Raspberry Pi render us immune to attacks of 
the sort. 
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GPIO 18 is used for 
the push-button 
input, which 

will change the 
direction of motion 
for the robot 


Push-Button 


A breakout 
; board is used in 
GPIO 4 is used this diagram to 
for the LED R-R-Br 


simplify the wiring 
process; you can 
also wire directly 
from the Pi 


output, which 
will indicate the 
current direction 
of the robot 


CONTROLLING LEGO 


MINDSTORMS 
THROUGH GPIO 
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LEGO 
Mindstorms robot 
(NXT or EV3) 


Breadboard 


Wires for 
breadboard 


1xLED 
1x Push-button 


1x 220Q resistor 
(Red-Red-Brown) 


1 10kQ resistor 
(Brown-Black- 
Orange) 


Construct a circuit to directly control a LEGO 


robot with the Raspberry Pi GPIO 


EGO Mindstorms is a great tool to gain 
experience in understanding robotics, but 
what if you wanted to make your own input 
sensor? In this guide, we will show how simple it is 
to construct a circuit to control a Mindstorms robot 
through GPIO in Raspberry Pi. 

We will show every step from connecting the robot 
to writing the code. The result will be a program in 
Ch, a superset interpreter of C/C++, to control the 
direction of the robot with a push-button. 


Software 

To make use of C-STEM’s programming tools, you 
should install the C-STEMbian operating system, 
which contains C-STEM Studio. This free, open-source 
operating system contains all the necessary tools for 
robotics and physical computing. Additionally, itis a 
superset of Raspbian, so all the familiar features will 
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still be there. If you already have Raspbian installed, 
the C-STEM modules can be installed separately on 
top. All of this is available from the C-STEMbian 
section of the C-STEM website (magpi.cc/2p3JUNP). 
Step-by-step guides will assist you in setting up and 
accessing the Raspberry Pi if needed. 


Connecting to the Mindstorms robot 
Connecting to your Mindstorms robot is quite simple 
with the C-STEM software. 
First, you will need to open C-STEM Studio and 
launch Ch Mindstorms Controller. Find the big ‘C’ at 
the top of the screen after logging in to your Raspberry 
Pi. Click the ‘C’, then navigate to ‘Ch Mindstorms 
Controller’ on the left side of the menu in C-STEM 
Studio. Click on Launch to open it. 

Ch Mindstorms Controller can connect with both 
EV3 and NXT robots. Simply press the Scan Robot 


— 
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CONTROLLING LEGO MINDSTORMS THROUGH GPIO 


TROUBLESHOOTING WITH GPIOVIEWER 


Remember to use GPlOviewer to test your circuit before 
programming. You can test both the LED and the push 
button with the GUI. 


button and add the robots that are found to the list 
on your robot manager. Follow the instructions on 
screen to pair the robots with your Raspberry Pi. Due 
to the limitations of Bluetooth, the Ch Mindstorms 
Controller can connect to a maximum of seven robots 
at atime. (Do make sure that the robots are turned on 
and have Bluetooth enabled!) 

Once the robots have been scanned and added to the 
list, select the ones you would like to connect to and 
press Connect. Robots that you are connected to will 
have a green dot next to their names. 


Building the simple circuit 

The program in this tutorial requires a physical 
circuit to function. Our circuit will consist of a 
push-button input to control the direction of the 
robot’s movement. An LED output will give a visual 
indication of the direction change when pressing 
the button. 

Looking at the circuit, there are two sides: input 
and output. The input side, shown on the right, has 
a push button in series with a 10kQ, resistor. The 
push-button is connected to 5V for power. GPIO 18 is 
connected between them to read the button input. 

The output side, on the left, has an LED in series 
with a 220Q resistor. GPIO4 controls this light. 

If you have one, use a breakout board to make 
the wiring process clearer. Otherwise, wire the pins 
directly from the Pi. Take a wire from GPIO 4 and 
connect it to an empty row of the breadboard. Then, 
attach the positive (longer) leg of an LED to this row. 
From the negative leg of the LED, attach a 2200, 
Red-Red-Brown) resistor to ground. 

For the push-button, insert it over the breadboard 
gutter. Wire 5V to one lead, and wire a10 kQ (Brown- 
Black-Orange) resistor from ground to the adjacent 
eg. Finally, connect a wire from GPIO 18 to the row of 
the resistor and push-button leg. This will carry the 
input signal when the button is pressed. 

Before programming, we can use GPIOviewer, a 
helpful feature of the C-STEMbian operating system. 
To use it, navigate again to the big ‘C’ at the top of the 
desktop window. 

Once open, navigate to Ch Raspberry Pi and click 
Launch in the bottom right-hand corner. This will 
open up GPIOviewer, which allows total control of all 
the GPIO pins on the Raspberry Pi. In this view, you 
can change pin modes between input, output, and 
PWM (with a slider). 

For this circuit, find GPIO 4 and set it to output. 

Ensure the LED is set up and working properly by 
switching between high and low outputs. If the light 
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turns on, you can move on to testing the input. 

Set GPIO 18 to input mode. Then, try pressing the 
button. If the input changes, the circuit is now ready 
for programming. 


Coding in Ch 
Programming in Ch starts by opening C-STEM 
Studio again on your Raspberry Pi. In v4.0, 
Navigate to Code in Curriculum > LearnPiprogram > 
mindstormsDirectionBot.ch. If you would like to make 
changes to the file, be sure to copy and paste it to 
another location before opening! To open the program 
with ChIDE, simply double-click it. The code for the 
project follows, which can be modified within the 
editing pane. 

When running the code, be sure that the 
Mindstorms robot is still connected through 
CMC! Otherwise, the IDE will not recognise that 


DOWNLOAD: 
magpi.cc/2mHpaF4 


When running the code, be sure 
that the Mindstorms robot is still 
connected through CMC! 


the bot is connected and therefore will not run the 
code on it. The code should drive the robot forward 
or backward continuously at a constant speed. When 
the user gives input via a button press, the robot 
should switch directions by negating its speed. The 
LED will also change states on a button press by 
checking if the speed is positive or negative. Let’s 
take a closer look at the Ch code to understand how 
this is done... 

The first thing to notice are the two headers, 
wiringPi.h and mindstorms.h. We use the wiringPi 
header to take inputs and outputs more easily from 
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Check that the LED is working correctly by switching between 
high and low outputs on GPIlOviewer 


High ‘ Low |\Output ~ 


Input ~ 0 


Check that the push-button is working correctly by making sure 
the input value changes after the button is pushed 


the GPIO pins. It allows the code to resemble Arduino 
code. To use the Mindstorms platform, we include 
mindstorms.h which contains all robot functionality 
like moving and turning. 


CMindstorms robot; 

Now, the program needs to declare a robot. In Ch, 
CMindstorms is a class that can be instantiated like a 
variable. For this program, the Mindstorms robot is 
referred to as ‘robot’; all functions related to it will be 
called using the robot. function format. 


double radius = 1.1; 
double speed = 5.0; 


The first variable holds the radius of the wheels on 
the Mindstorms robot in units of inches. Remember 
that the radius of a circle, or wheel, is the distance 
from its centre to the edge. After that, a variable 

for speed is set to 5 inches (12.5cm) per second. 
Depending on the Mindstorms wheels attached, the 
radius may be different. By storing the value ina 
variable and passing it to functions, the code is easily 
adaptable to various sizes. If unsure, the radius of the 
physical wheel can be measured, especially if using a 
custom wheel. 


int switchVal; 

int directionPin = 18; 

int ledPin = 4; 
wiringPiSetupGpio() ; 
pinMode(directionPin, INPUT); 
pinMode(ledPin, OUTPUT) ; 


Variables for the current switch value as well as the 
input/output pins are declared similarly to previous 
projects. Then, the pins are set up and initialised. 


robot.driveForeverNB(); 

Before entering the while loop, the robot 

is set to continuously move using the 
driveForeverNB() function in the CMindstormsI 
class. It will drive forever in whatever direction 

it is currently facing. Forcing the robot to move 
constantly makes this code and physical circuit easier 
since the only input needed is the direction change. 

t is important not to use the driveForever() 
version without the ‘NB’ letters. For these functions, 
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‘NB’ stands for ‘non-blocking’, which allows the 
code to continue after the function has been called. 
Without the ‘NB,’ the code would stop at the function 
because it ‘blocks’ the program from continuing until 
it finishes. 


while(1){ 
switchVal = digitalRead(directionPin) ; 
delay(50); 


if (switchVal == HIGH) { 
speed = -speed; 

robot .setSpeed(speed, radius) ; 
robot.driveForeverNB() ; 


} 


The first section inside the infinite while loop 
checks the direction-changing pin. There is 

a delay(5@), meaning wait 50 milliseconds, 

to ensure a clean reading of the pin. Without 

this, it may switch directions multiple times 

ona single press. If the pin reads a value of 

‘HIGH’ or ‘1’, it will reverse the direction of 
movement. To accomplish this, the speed is set 
equal to its negative counterpart. For example, 

if the speed was 5 inches/second, this will 

change it to -5 inches/second. Therefore, the 
Mindstorms robot will move just as fast in either 
direction. Writing a new speed to the robot 

also requires the setSpeed() function in the 
CMindstormsT class. Notice that this function also 
requires the radius of the wheel because it uses this 
value to calculate how fast the wheel must spin 

to achieve the correct distance. Finally, one more 
robot .driveForeverNB() call is made to ensure the 
robot continues to move. 


if (speed >= @) { 
digitalWrite(ledPin, HIGH); 
} 

else { 

digitalWrite(ledPin, LOW); 
} 

} 


To end the while loop, an if statement controls the 
state of the LED. When the robot’s speed is greater 
than zero, it must be moving forward. In this case, 
the LED turns on. The LED turns off while the robot 
is moving backwards by checking if speed is less 
than zero. 

If you want to take this project a step further, try 
connecting multiple robots and control them with 
the same circuit! Additionally, you can add LED 
traffic lights and make the robot move according 
to the lights. Or, come up with your own idea! Now 
you have the tools to make circuits that can interact 
with robots. 
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CODING GAMES 
ON THE RASPBERRY P1 


Code::Blocks 


Some 
imagination 


Abit of patience 


Figure 2 
Locate 

your Build 
Options button 


IN C/C++ BEER 


After our setup of systems, it’s time to get some graphics sorted out 


ast time, we demonstrated that it's pretty 
easy to get a few objects created and doing 
something — they just weren’t doing very 
much that would interest us. Now it’s time to take 
a bit of a plunge and set up a means to display 
some graphics. This will give our objects a bit more 
substance and allow us to do a lot more cool things 
with the framework we are building. 

Last time, we kicked off our project in our Main 
function, then went off to let a Game class do some 


work by printing some text to a console screen. If we 
want to do graphics, we need to have a graphics screen 
to draw to; the console screen is for text only. 

Setting up a graphics screen is a bit of a techy 
minefield, but we can explain the basics and provide 
the code for you to get started We’ll go in to a little 
more detail on the tech another time. Use the new 
project from the GitHub repository; there are a few 
additions/changes, but it should still be recognisable 
from the last version. 
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Using a library 

n order to create graphics, we need to use libraries 
that give us access to the GPU features. Our IDE needs 
to know in which directories the libraries we use are 
ocated; this is a complicated mess, but needs to be 
done! Of course, the supplied project has this already 
set up for you so you can use that, but it’s good to 
know how to set these up. 

In Code::Blocks, select the Project menu, choose 
Properties, then select the Build Targets tab (Figure 1). 
Click on the Build Options button to bring up 
another selection of tabs, but this time select the 
Search Directories tab. 

You will be presented with a default empty Compiler 
tab. Select the Add button and a dialogue will come 
up with your current default project directory, but we 
don’t want that - click on the ‘...’ button and navigate 
to File System > opt > vc > include and select open. 
Keep this as a relative path when it asks. Repeat for: 

File System > opt > vc > include > interface; 

File System > opt > vc > include > interface > 
vmcs_host > linux; 

File System > opt > vc > include > interface > 
vcos > pthreads. 

Good, that’s the compiler sorted; it will know where 
to look for headers. Now choose the Linker Settings 
tab, on the top row of tabs. 

Tell the linker that we want to include binary 
libraries. Click on Add, then the ‘...’ button, and 
navigate to File System > opt > vc > lib. 

Depending on which version of Raspbian you’re 
using, you’ll need to load different files. For Raspbian 
before November 2017, hold CTRL and select three 
files: libbcm_host.so, libEGL.so, and libGLESv2.so. 
For the latest version of Raspbian Stretch, the file 
names are a little different and there are six: 


Cr 
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main.cpp, 
SimpleObj.h/cpp, 
Game.h/cpp 


DOWNLOAD: 
magpi.cc/2mJqLKG 


Figure 2 
Anew Draw 
routine 


libbcm_host.so, GLESv2_static.a, EGL_static.a, 
vchiq_arm.a, vcos.a, and khrn_static.a. 

Click OK and also keep them relative. 

We’re done for now. Click OK to return your project, 
ready to enter code, but be aware that we’ve only set 
up our debug configuration. 


Working with the GPU 

Our GPU processes the commands we send to it and, 
using information we store in a data structure called 

a context, it puts the results of those commands on 
screen. The GPU and context both need to be initialised 
to get them up and ready to accept those commands. 
We’ll explain the commands a little later on, but 

for now our prime aim has to be to get the GPU and 
context ready. 


The GPU and context both need to 
be initialised to get them up and 
ready to accept those commands 


Look at the file OGL.cpp; we’ve put all the 
initialisation code in at the start. Now we can create 
an OGL class, and call its init method, to set up 
OpenGLESz2.0 ready to do its magic. 

You might at this point be wondering what 
OpenGLES2.0 is® Simply put, it’s an interface system 
that allows you to control any GPU which is using the 
OpenGLES2.0 standard. Different manufacturers’ 
GPUs work slightly differently at the hardware level, 
so the interface or API gives a consistent way to ask 
for certain specific things to happen in certain ways. 
The hardware/driver coders make sure this happens 
regardless of the GPU architecture. 


CHECK THE 
ERRORS 


Errors can be 
confusing. It's 


best to focus 
on and fix the 


first couple: 
fixing those 
often fixes 
the others. 
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TYPE, DON'T 
PASTE! 


Typing slowly 
and carefully 


forces you to 
think about 
what you enter, 
and helps you 
to manage 
your code. 


Getting a graphic screen 

Initialisation of our OpenGLES2.0 systems only 
needs to happen once, so it can sit happily as a first 
constructor step in our Game class. To use the OGL 
class, simply make sure you have added the OGL.h 
and OGL.cpp files to the Hello World project, then 
add an #include OGL.h to your Game and SimpleObj 
class header files. We also need to add an instance 
OGL in the Game class description, like this: 

OGL OGLES; 

Now make sure your Game constructor has 
OGLES.Init() and we’re ready to go. Build and Run 
your new code, and your Hello World console will 
still function as before, but now you will see you have 
two windows. 

The console screen is still there if we need it for 
outputting text, but now we also have a graphic 
screen. But how do we draw something to it? That 
comes back to those commands we need to send, 
and our currently empty Draw function in the 
SimpleObj class. 


The console screen is still there if 
we need it for outputting text, but 
now we also have a graphic screen 


Figure 3 
Only one 
triangle? 


BE FLEXIBLE! 


Things change, 


update, get 

revised; don't 
get stuck into 
fixed thinking! 
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In the new Simp1leObj class (download) you will 
see there are a few additions, most notably a data 
structure called an array which holds data for a 
triangle, and the now completed Draw function. 

The Triangle structure is a list of offset points, 
from an assumed centre of 0,0,0, which basically 
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defines the vertices that make up a triangle. There 
are three points, each with an x, y and z coord, 
though z is always 0 for 2D. 

Now, if we send those points to the GPU and let it 
know it’s being asked to draw a triangle, it will store 
the data in its memory and then send each point toa 
pair of shaders. This is where OpenGLES2.0 becomes 
complex. But fear not: shaders are only confusing 
for a little while, then you start to realise just how 
amazing they are. 


What's a shader? 


Shaders are a big topic — in graphics terms, quite 
possibly one of the biggest - so we won’t be able to 
go into much detail here, but for sure we will cover 
them later. Let’s just start with a very basic outline 
and build in a working system we can use. 

We always have a pair of shaders which work 
together, one after the other. The first shader 
is the vertex shader. This contains code which 
works out where in our screen we locate a vertex. 
Once that’s set up, it then passes control toa 
fragment shader which is there to basically decide 
on what colours to use to fill the area defined 
by the vertices. 

What’s both confusing and cool about shaders is 
that we have to write them ourselves. This effectively 
gives us total control over what gets drawn on 
screen and where. Which can be awesome or terrible 
depending on how well we do it. 

We’ve set up a very simple pair of shaders in the 
OGL init. That’s not really a good way to do things, 
but it’ work for now. 

Now, the last complication to cover with shaders 
is that they exist in the GPU memory, not in our 
code memory, so we have to send them information 
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to do things. Data we send to the shader are called 
attributes or uniforms. Attributes are usually lists 

of changeable supplied data, such as the position 

of each vertex, which are read in turn as the shader 
operates. Uniforms are unchanging constant values 
set up once, before the gldraw is called. 

Are you getting bored with all this tech description 
yet? It is quite a lot of info and new buzz words for a 
beginner but we are nearly there and can soon start 
to put things on screen. 


Let there be triangles, please? 
The GitHub project is fully working, but try to 
add OGL.cpp/h and then edit your current Hello 
World project to gain these new graphics — 

it’s good practice. 

The SimpleObj draw routine is basically setting 
up the attributes it wants sent to the GPU (i.e. the 
triangle data) and then sends the uniform info that 
is used to modify those attributes. Once set up, 
an actual draw call is sent to the GPU to tell it to 
do its thing. 

But that’s not the end of it. The OpenGLES2.0 draw 
call does not write to the visible screen — instead it 
writes to a back buffer. This allows us to do multiple 
draw calls, without seeing the screen glitching. When 
all our draw calls are done, we ask the GPU to swap 
the back buffer to the visible screen; that’s done at 
the end of the game update loop, and then we see the 
results of our efforts. 

Add in the new code from the draw function in 
Figure 2, or refer to the new SimpleObj.cpp file. 

If you Build and run (Fg) now, with no changes to 
your update, you can see you are getting one triangle 
(Figure 3). But you are outputting text for two 
objects. Any ideas? 
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Listen to your 
linker errors! 


Figure 4: 

And our two 
objects now 
have graphics 


It’s not as complex as it might seem: there are in 
fact two triangles there, but they are both occupying 
the same position, so we only see the last one drawn. 
Also, the update routine should be responsible for 
moving them around, so that when the draw sends 
its position as a uniform to the GPU, it will senda 
unique position allowing us to see both triangles. 

Make the changes seen in the new SimpleObj.cpp 
file, to the update routine; but also when you create 
them in the Game class, add a different x,y position 
for each of them. 
Build and run it again and something wonderful 
hould happen: we should be seeing two red 
riangles moving around the screen and bouncing off 
he edges (Figure 4). This is rather a limited demo, 
hough, and we are restricted to x and y co-ords of 
-1.0 to +1.0, which is hard to visualise, but we’ll fix 
that next time. 

We have objects with graphics... again, very 
imple graphics, and not especially useful unless 
you are writing a bouncing triangle game. But, we 
do have graphics. The next step is to create a more 
useful type of graphic, with a recognisable pattern 
on it. 

Sadly, that’s going to need a bit more techy work. 
This foundation work is dull, but it’s done now; next 
time we can start to do some actual control code. 
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LEARN TO CODE WITH C 


Enjoying using C and C++ and can't wait until next 
month for more? Check out our Essentials book, 
Learn to Code with C, for more C tutorials for 
beginners: magpi.cc/learn-c-book 
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YOUR QUESTIONS ANSWERED 


In store 

The MagP1 is available to buy in stores in the UK and 
US, although we’ve heard of some smaller stores in 
other countries stocking the magazine. You can find 
The MagPi on the last Thursday of every month in 
selected WH Smith, Sainsbury, Tesco, and Asda stores. 
In the US, you can get it a few days later from Barnes & 
Noble and Micro Center. 


Online 

All issues of The MagPi are sold on day of release from 
the Raspberry Pi Press store: store.rpipress.cc. These 
ship to just about everywhere in the world. You can 
also buy issues of HackSpace magazine, along with all 
our Essentials books and Projects books. 


Digitally 

As well as the free PDF download, you can get our 
dedicated iOS and Android app; this allows for better 
reading options on your device. You can buy single 
issues or get a digital subscription through the app 

— and you get the first 30 issues of the magazine 
completely free. 


Subscription offers 

We offer a number of subscription offers for 

The MagPi on our website, which you can find here: 
magpi.cc/Subs1. We have specific offers for people 
living in the UK, Europe, and the USA, as well as 
our ‘Rest of the World’ option for other countries. 
For example, Canada is included in the Rest of the 
World option. 
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NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Eligible countries <~"** 
We do not have any 
restrictions on where 
the Rest of the World 
subscription option 
canshipto.Thecost jg 
of postage is included 
in the price you pay as 
well. It is much cheaper to buy a 
subscription than to buy the individual 
issues as they’re released, especially when you 
don’t live in the UK. 


Free Pi Zero W 

With a twelve-month subscription to the print version 
of the mag, you also get a free Pi Zero W along with 

a case and a selection of adapter cables. This offer 
currently does not have an end date, but make sure to 
check the descriptions on our subscription package to 
make sure it hasn’t changed since the time of writing. 


MagPi issues 

Generally when we sell out of copies of The MagPi, 
there will not be a reprint of that issue. While we have 
done so in the past with issue 40, that was a special 
case. If we ever have plans to print more of an issue, 
we’ll let people know via our social media channels or 
via our newsletter: magpi.cc/Email-me. 


Essentials books 

We do often reprint the Essentials books, so if you’ve 
missed one you’! just need to wait a while and they’ ll 
eventually be back in stock. Some books have higher 
demand than others, though, so make sure not to 
miss out if you need one ASAP! 


Other books 

The project books we generally keep in print, and the 
new Beginner’s Book will definitely be available in print 
for the foreseeable future. However, other books will go 
in and out of print with demand. Remember, everything 
we release is also available as a free PDF — so if you can’t 
buy a physical copy, you can print off the bits you need. 
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RASPBERRYPI.ORG/HELP 


WHAT OPERATING SYSTEM (OS) DOES IT USE? 

There are several official distros available on our downloads page. 
New users will probably find the NOOBS installer the easiest to 
work with, as it walks you through the download and installation 

of a specific distro. The recommended distro is Raspbian, which is 
specifically designed for the Raspberry Pi and which our engineers 
are constantly optimising. It is, however, a straightforward process 
to replace the root partition on the SD card with another ARM Linux 
distro, so we encourage you to try out several distros to see which 
one you like the most. The OS is stored on the SD card. 


DOES IT HAVE AN OFFICIAL PROGRAMMING LANGUAGE? 

The Raspberry Pi Foundation recommends Python as a language 
for learners. We also recommend Scratch for younger children. 
Any language which will compile for ARMv6 (Pi 1, Zero, A+, and later 
models), ARMv7 (Pi 2 and Pi 3), or ARMv8 (Pi 3 and later Pi 2, when 
running a 64-bit kernel) can be used with the Raspberry Pi, though, 
so you are not limited to using Python. C, C++, Java, Scratch, and 
Ruby all come installed by default on the Raspberry Pi. 


WILL IT RUN WINE (OR WINDOWS, OR OTHER X86 SOFTWARE)? 

In general, this is not be possible with most versions of the 
Raspberry Pi. Some people have put Windows 3.1 on the Raspberry 
Pi inside an x86 CPU emulator in order to use specific applications, 
but trying to use a version of Windows even as old as Windows 

g8 can take hours to boot into, and may take several more hours 

to update your cursor every time you try to move it. We don't 
recommend it! A special version of Windows 10 is available for use 
on the Raspberry Pi 2 and 3. This is an entirely new version of the 
operating system designed exclusively for embedded use, dubbed 
the Windows 10 Internet of Things (loT) Core. It does not include the 
user interface (‘shell’) or the desktop operating system. 


WILL IT RUN THE WINDOWS 8 ARM EDITION? 

No. Most models of Raspberry Pi lack the minimum memory 

and CPU requirements to support Windows 8 ARM edition. The 
Raspberry Pi also lacks the appropriate axis sensors, and there are 
many other limiting factors which mean that running Windows 8 
ARM edition is not possible. 
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Make your own distr 
and learn to hac 


luster computing, or 
distributed computing, 
is a hot topic in today’s 


computer landscape. Rather than 
use a single computer to perform 
calculations, you string a whole 
bunch of them together to forma 
single system. 

Cluster computers are often used 
to perform complex calculations 
that would take a single computer 
along time. Each computer 
(referred to as a ‘node’) handles 
part of the task. Typically, a cluster 
computer is faster than a single 
computer and, because they’ re 
made of mass-produced parts 
like our Raspberry Pi, also much 
cheaper than a supercomputer. 

They’ re not faster at everything, 
though. You won’t be able to 
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g system 


run faster games, or run more 
complex software with a cluster 
of Raspberry Pi computers. But 
you will learn all about some of 
the most important and advanced 
computing techniques around 
today, such as cyrptography, 
including encryption, decryption, 
and much more. 

In this feature we look at 
building a cluster computer 
called OctaPi. This was developed 
by GCHQ (Government 
Communications Headquarters) 
who worked with the Raspberry Pi 
Foundation to develop resources. 

These resources are some 
our most advanced educational 
materials on the Raspberry Pi 
website, and are ideal for those 


looking to study computer science. 
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RASPBERRY PI ‘208 Px 


Eight Raspberry Pi — 


computers, known ROUTER 
as ‘servers’, are ; 
connected to the Each Rae eeag) 
SAND NEC is connected to the 
same router (which is 
not connected to the 


internet). Each Pi is 
assigned its own 
IP address 


UNICORN HAT 


The Raspberry Pi boards 
in this OctaPi also wear 
Unicorn HATs. The visual 


» LED displays on these 
boards provide visual 
feedback when the Pi POWER ; 
\ devices are processing Each Raspberry Pi 
>. problems requires its own 
eS microSD card 
& (running the same 
XN software) anda 
—— power supply 


LAURA SACH 


Laura creates and maintains 
Raspberry Pi educational 


resources. Aside from computers, 
she loves cats, cakes, board 
games, and making jam. 
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BUILD A CLUSTER COMPUTER 


The OctaPi is a cluster computer, which uses several computers to boost its power. 
Discover how to connect Pi boards together to form a cluster 


> 9 x Raspberry 
Pi 3s 


> 8 x Unicorn HATs 
(optional) 


> 8 x Short micro 
USB cables 


> Wireless router 
> Power hub 


> Ethernet cable 
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Once up and running, 
the processors in each 
Raspberry Pi crunch part 
of a problem. Together 
they can solve complex 
problems like encryption 
and decryption of codes 
faster than a single 
Raspberry Pi 


This system is known as a 
cluster computer, a kind of cloud 
computer. It’s made using eight 
Raspberry Pi computers (known 
as ‘servers’), all controlled bya 
single Raspberry Pi (known as 
the ‘client’). 

The power of the eight server 
CPUs (32 cores) will allow you 
to execute computations from 
the client CPU much faster than 
the client could perform them 
on its own. Once you complete 
this project, you will be able to 
develop applications in Python 3 
on the client and run them on 
your cluster. 


There are three steps you will 
need to take to make an OctaPi: 
Create a WiFi network for the 
cluster using a dedicated router 
Create a client machine 

Create eight servers 


The Raspberry Pi 
boards are connected 
to the same wireless 
network, cutting out 
the need for Ethernet 
cables (which can be 
used as an alternative) 


The cluster_action script is used to 
control the Raspberry Pi boards 


The processors in your OctaPi 
cluster will communicate via a 
dedicated local WiFi network 
established by a single wireless 
router. The router does not need 
to be connected to the internet 
at all for operation of the cluster, 


Aninth Raspberry 
Pi, known as the 
‘client’ is used to 
control the eight 
Raspberry Pi 
‘servers’ that form 
the OctaPi 


nor does it need to be online at a 
setup. We will assume you are using 
a brand-new router or have reset 
your router to its default settings. 

Connect a computer to the router 
using an Ethernet cable. You can 
use any computer system that has 
a web browser, including a working 
Raspberry Pi3. 

Follow the setup instructions 
that came with the router. This 
normally involves opening a web 
browser and navigating to your 
router’s ‘admin’ page to start 
changing the router settings. The 
‘admin’ login credentials will 
have been provided by your WiFi 
router manufacturer. 

Look for a page which allows 
you to set the WiFi network name 
(also called SSID) and change it to 
‘OctaPi’. For example, the page may 
look like the one shown in Figure 1. 


Figure 2A router interface allowing 
you to change the WiFi network name 


Raspberry Pi 3 computers only 
work with 2.4GHz WiFi, so you 
can either ignore 5GHz settings or 
disable 5GHz WiFi in your router. 
Now look for the LAN IP settings, 
which may be under the ‘LAN’ 
settings. Change the IP address 
of your router to 192.168.1.1 - 
again, each router’s administrator 
interface will be different, but 
Figure 2 shows an example of what 
you might see. 
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You may need to reboot your 
router and log back in as ‘admin’ 
after this step. 


Figure 2 Change the LAN address 
of your router to 192.168.1.1 


Set the network 

Now set the WiFi network 
password, which may be under 
‘Wireless security’ or similar. It is 
important to ensure that you write 
down the password so that you can 
use it to log into your dedicated 
‘OctaPi’ network. 

Look for the DHCP settings. 
DHCP is a protocol used for issuing 
IP addresses automatically. The 
client and servers will use this to 
determine their IP addresses. The 
settings for DHCP may be under 
‘LAN’. Make sure that DHCP is 
enabled, and set the DHCP address 
range to something that provides a 
useful range of addresses; we chose 
192.168.1.2 to 192.168.1.254. Using 
this particular range is not critical, 


Figure 3 Turn DHCP on and set the IP range 
from 192.168.1.2 to 192.168.1254 
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but using a different one here will 
mean the IP addresses you see 
will differ from those shown in 
this guide. Only choose a different 
range if you know what you are 
doing. See Figure 3. 

If there is a setting for the IP 
lease time, make this number as 
large as possible. The lease time 
is the length of time before DHCP 
reallocates IP addresses — you need 
it to be long to avoid interrupting 
the connection between the client 
and servers. 

Reboot your WiFi router so that 
all the changes come into effect. 


The OctaPi client 


One of the Raspberry Pi computers 
will be used as the client machine 
giving access to the servers in 
the OctaPi cluster. You will need 
to connect the usual peripherals 
(monitor, keyboard, mouse) to this 
Raspberry Pi in order to use it to 
control the OctaPi. 

On your microSD card, install 
the latest version of Raspbian 
by following the software guide 
instructions (magpi.cc/2eopaEf). 

Using this microSD card, boot up 
the Raspberry Pi 3 with a keyboard, 
screen, and mouse connected. 
Ensure the Raspberry Pi is also 
connected to the internet. 

Now open a Terminal window 
and install dispy by typing this 
command into the Terminal: 


sudo pip3 install 
dispy==4.7.1 


Dispy is a distributed Python 
implementation that will allow 
you to write code on the client and 
run it across the servers. Note, It 
is crucial that you install version 
4.7.1 of dispy, as later versions 


rely on a library that is currently 
incompatible with Raspbian. 
Further information is available 
from dispy: Distributed and 
Parallel Computing with/for 
Python (magpi.cc/2mkiXid). 


Next, install nmap by typing this 
command into the Terminal: 


sudo apt-get install nmap 


Nmap is used to discover the IP 
addresses of the Raspberry Pi 
servers forming the OctaPi cluster, 
so that they can be shut down or 
rebooted as needed. 

If you are using the optional 
Unicorn HATs, install the software 
for them by typing this command: 


curl https://get.pimoroni. 
com/unicornhat | bash 


You will need to reboot your Pi 
after installing this software. Make 
sure you are in the /home/pi 
directory, then download the 
OctaPi client software by typing 
this command into the Terminal: 


git clone https://github. 


com/raspberrypilearning/ 
octapi-setup.git 
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The client software contains 
source code examples in Python 3 
and a Bash control script for 
rebooting and shutting down the 
cluster. The control script can be 
used with the Unicorn HAT as well. 
Move all of the files from the client 
folder you just downloaded into the 
home/pi folder: 


mv /home/pi/octapi-setup/ 
client/* /home/pi 


sudo pip3 install psutil 


Dispy uses psutil for reporting CPU 


usage of the servers in the cluster. 
Ensure you are in the home/pi 
directory by typing cd /home/pi. 
If you are using the Unicorn HATs, 
install the software for them 

by typing this command into 

the Terminal: 


curl https://get.pimoroni. 
com/unicornhat | bash 


You will need to restart your Pi 
afterwards. Then, reopen the 
Terminal and make sure you are in 


Do not run nmap on a network that 


Shut down your new OctaPi client 
for the time-being and set aside 
the client SD card in a safe place. 


The OctaPi servers 
Each of the Raspberry Pi 3 
computers in the cluster needs 
to have its own microSD card 
prepared. However, because each 
card is identical, you can set up just 
one server, check it’s working, and 
then replicate the SD card for the 
other servers. 

On anew microSD card, install 
the latest version of Raspbian 
by following the software guide 
instructions (magpi.cc/2eopaEf). 

Boot up a Raspberry Pi 3 using 
this SD card with a keyboard, 
screen, and mouse connected. 
Ensure the Raspberry Pi is 
connected to the internet. 

Install dispy by typing this 
command into the Terminal: 


sudo pip3 install 
dispy==4.7.1 


Install psutil by typing this 
command into the Terminal: 
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is connected to the internet 


the home/pi folder by typing 
cd /home/pi. 

Download the start_unicorn.sh 
Bash script for installation on the 
server using this command: 


wget https://raw. 
githubusercontent.com/ 
raspberrypilearning/octapi- 
setup/master/server/start_ 
unicorn.sh 


Make the script executable by 
typing this command: 


chmod u+x ./start_unicorn.sh 


Go back to the Terminal window 
and type the following command to 
begin editing the /etc/rc.local file: 


sudo nano /etc/rc.local 


Near the bottom of the file, just 
before exit 0, add the following 
lines to run dispy as a daemon (a 
process running in the background) 
each time the server boots: 


sleep 20 

_IP=$(hostname -I) 
/usr/local/bin/dispynode. py 
-i "$ IP" --daemon --client_ 
shutdown 


The sleep for 20 seconds is to allow 
time for the server to log onto your 
WiFi router and obtain a network 
IP address from it. You need the 

IP address so that the server will 
listen properly for the client on the 
network. You may have to adjust 
this delay to suit the router you 

are using. 

Press CTRL+0 to save your 
changes, then CTRL+X to exit the 
nano editor. 

Check that remote login via 
SSH is enabled so that remote 
command-line access to 
your server is possible. In the 
Preferences menu, select Raspberry 
Pi Configuration. Then click on the 


Figure 4 Enable SSH in the Interfaces tab in Raspberry Pi Configuration 
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Interfaces tab and make sure that 
SSH is enabled (see Figure 4). 


Set up the server 
Still using the server Raspberry 
Pi, we need to switch from the 
internet-connected network to 
the OctaPi network. Ensure your 
OctaPi WiFi router is powered up 
and fully booted. 

Click on the WiFi symbol at 
the top of the desktop and select 
the ‘OctaPi’ network. Enter your 
router’s network password (which 
you noted down earlier) to join 
the network. 

Having done this, the server will 
remember the WiFi credentials and 
log onto your dedicated ‘OctaPi’ 
network each time it boots. 

We need to remove any previous 
WiFi information to avoid 
confusion. In a Terminal window, 
type the following command to 
edit the wpa_supplicant.conf file: 


sudo nano /etc/wpa_ 
supplicant/wpa_supplicant. 
conf 


The file contents look like this: 


ctrl_interface=DIR=/var/run/ 
wpa_supplicant GROUP=netdev 
update_config=1 

country=GB 


network={ 
ssid="OctaPi" 
psk="mynetworkpassword” 
key_mgmt=WPA-PSK 


Remove any ‘network { }’ sections 
for other networks (do not remove 
the OctaPi one shown here). Press 
CTRL+tO to save and CTRL+X 

to exit. 

If alternative WiFi networks are 
not removed, your server may log 
into the wrong network and not be 
available to the client. 

When finished, shut down the 
server Raspberry Pi. 
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Set up the client 
Now connect a monitor, keyboard, 
and mouse and power up a 
Raspberry Pi containing the client 
SD card you created earlier. 

Repeat the instructions 
from the previous step on this 
computer, logging into the ‘OctaPi’ 
network and removing any 
alternative WiFi details from the 
wpa_supplicant.conf file. 

Keeping the client switched on, 
boot up a single server Raspberry Pi 
with only a power lead connected. 

Open a Terminal window on 
the client Raspberry Pi. Type the 
following command to find the IP 
address of the client Raspberry Pi: 


hostname -I 


Type the following command 
to find out the IP address of the 
server Raspberry Pi: 


nmap -sP 192.168.1.* 


Make a note of the server IP 
address (you should see the 
router’s address, which will be 
192.168.1.1, and the client’s address 
listed, too). 

The nmap software scans the 
network to find the IP addresses 
of the devices connected to 
it. We need to do this on our 
local network so that the client 
machine can communicate with 
the Raspberry Pi computers which 
form the OctaPi cluster. Do not 
run nmap on a network that is 
connected to the internet. Nmap 
is a powerful piece of software 
and using it to scan a network you 
do not own may be considered 
hacking, and in some countries 
may even be illegal. 
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On the client, run ssh-keygen 
in the Terminal to create a key 
for authenticating the client with 
the server. 

Press ENTER when asked where 
to save the key, and press ENTER 
again twice when asked fora 
passphrase, leaving it empty. 

This key is used to help the 
cluster_action.sh script (provided 
with the client software) to run 
with the servers. 

Find where you noted down the 
IP address of the server machine, 
and run this command ina 
Terminal on the client to copy the 
key to the server (replace <remote 
ip> with the server’s IP address): 


ssh-copy-id -i ~/.ssh/id_ 
rsa.pub <remote ip> 


You will be asked if you want to 
continue connecting. Type yes 


Jobs Sec/Job Node Time Sec 


16 12.841 205.460 


Total job time: 205.460 sec, wall time: 57.347 sec, speedup: 3.583 


Figure 5 


Each Raspberry 
Pi needs its own 
power supply. In 
this OctaPi build, a 
powered USB hub 
is used to provide 
power to all the 
boards. You can 
also use multiple 
Raspberry Pi power 
adapters 
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re to chec! 192.168.1.49 (raspberrypi) 


4 
192.168.1.202 (raspberrypi) 4 
4 


192.168.1.191 (raspberrypi) 13.029 26.058 
192.168.1.223 (raspberrypi) 4 0.000 0.000 
192.168.1.116 (raspberrypi) 4 10.025 20. 050 


and press ENTER. You will be 
asked for the server Pi’s password, 
which will be the default password 


of raspberry. 

This completes preparation of 
the client and server. We now 
need to check everything is correct 
and working properly witha 
single server. 


Check that it works 
Make sure your dedicated ‘OctaPi’ 
router is powered on and fully 


192.168.1.27 (raspberrypi) 
192.168.1.167 (raspberrypi) 
192.168.1.50 (raspberrypi) 


Total job time: 223.548 sec, wall time: 20.245 sec, speedup: 11.042 


example software provided with 
the client software examples you 
downloaded earlier: 


We can't wait to hear how you 
got on with this challenge! 


booted up, the client is booted 
with peripherals attached, and the 
server is booted with only a power 
lead attached. 

Open a Terminal on the client. 
Make sure you are in the home/pi 
directory and type the following 
command to run the compute.py 
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sudo python3 compute. py 


The compute.py Python script 
runs 15 jobs on your server. They 
are all just random delays before 
returning. If the OctaPi is working 
correctly, the jobs will complete in 
about a minute and a table showing 
the statistics for the application 
will be shown in the Terminal. 

You should see a result similar 

to Figure 5. 

If the compute.py script does 
not work, review your steps one by 
one and check that client, server, 
and router are all set up correctly 
and working properly. 

If the test worked, use the client 
to manually shut down the server 
(replacing <remote_ip> with the 
IP address of the server you noted 
down earlier): 


ssh <remote_ip> 
sudo shutdown -HP now 


You may need to use nmap again 
to find the server IP address if it 
changed when the WiFi router 
rebooted. In future we will be using 


the cluster_action.sh script to do 
this. Once the server is shut down, 
remove its microSD card. 

Using an SD card duplicator or 
a computer that is able to read SD 
cards, create seven more identical 
copies of this SD card and insert 
them into the other servers so that 
you have a total of eight. 


OctaPi 
physical setup 
Decide how you will power your 
OctaPi. You could simply power 
each of the eight Raspberry Pi 
computers separately using eight 
standard power supplies, or you 
may find it more convenient to use 
a USB hub or charger in order to 
power them centrally. 
If you are using the Unicorn 
HATs, install a HAT onto the GPIO 
connector of each of the servers. 
If you wish, you can mount 
the eight Raspberry Pi 3s onto 
a backboard. Alternatively, 
there are cases for multiple 
Raspberry Pis available for 7 
purchase, or you can simply 
leave them laid out — they 
will work as aclustereven {# 
if they aren’t attached V, 
to anything. 


j 
Using the 4 
com aie | 
Octa 
Ensure a the ( 
dedicated WiFi router, 


ee 


BUILD AN OCTAPI 


all the servers used to execute 
the job will be listed in the table. 
The result should look similar 
to Figure 6. 

Try running the compute_pi_ 
efficient.py example software: 


sudo python3 compute_pi_ 
efficient.py 1000 100000 


If the OctaPi is working properly, 
you can start to do useful 


From a Terminal, type the 
following command to remove the 
ip_list file: 


rm ip_list 


Setting up the : 
cluster_action script 
On the client machine, open a 
Terminal. Make sure you are in 
the home/pi directory by typing in 
cd /home/pi. 


Figure 7 Estimating the value of pi using the 
‘dartboard’ method oe 
of the value of pi using the 


client, and OctaPi servers are all 
powered up. It’s best to power up 
the WiFi router well in advance 
so that you can be sure it is fully 
booted before the OctaPi client and 
servers attempt to log into it. 

On the client machine, 
open a Terminal. Try running 
the compute.py example 
software again by typing the 
following command: 


Controlling 
the cluster 


OctaPi is perfectly set up and 


control it. 


sudo python3 compute.py why we used ssh-keygen to 


calculations, like this estimation 


‘dartboard’ method (Figure 7). 


Now that you have checked your 


running without a hitch, you can 
use the cluster_action.sh script to 


The cluster_action.sh script 
runs on the client and uses SSH 
to administer the servers (that’s 


Now set the permissions for the 
cluster action script so that you can 
run it by typing this command: 


chmod u+x ./cluster_action.sh 


Ensure the client can recognise 
each server SSH key The first time 
you use the cluster, you may need 
to connect to each server via SSH 
with the client so that it recognises 
each server’s SSH key properly (be 
sure to replace <ip address of 
server > with the actual server 

IP address). 


authenticate the client with the 
servers). It relies on the correct 

IP addresses of the servers being 
listed in the ip_list file. It is a good 
idea to delete the ip_list file when 
booting the cluster for the first 
time so that the list is regenerated. 


If the OctaPi is working correctly, 
_at the end of the run 


ssh <ip address of server> 


If at all, doing this will only be 
needed once. 

We can’t wait to hear how you 
got on with this challenge! 


The following parameters are accepted by the cluster_action script: 


REBOOT 
Reboots all the servers (the client and router are ignored). 
For example: 

.-/cluster_action.sh reboot 


SHUTDOWN 


Shuts down each server and places it into a safe state. Ifa 
server is not shut down correctly, it may cause the microSD 
card to be corrupted and lead to the processor failing to 
boot when next used. For example: 

./cluster_action.sh shutdown 


DATE 


Distributes the client date and time (to the nearest minute) 


raspberrypi.org/magpi 


: to each server. The Raspberry Pi 3 does not have a real-time 
- clock, so the correct time will need to be set on the client 


first. For example: 
sudo date -s "11 Apr 2017 12:42" 
./cluster_action.sh date 


UNICORN 
Invokes the start_unicorn.sh script on each server and 
passes it the name and location of a Pimoroni Python 
script as a parameter. For this to work you need to have 
start_unicorn.sh in /home/pi on each server as described 
earlier. For example: 

-/cluster_action.sh unicorn /home/pi/Pimoroni/ 


_ unicornhat/examples/random_sparkles.py 
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PROJECTS BOox 


VOLUME 3 —-——— 


€ FNOTIOA AOOE S.LOsSCOUd Id AMBMAAdMS VU TWIOIAAO AHL 


GULLY PUL - OUTYQOY (O SHICA OOF 


£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


VOLUME 3 


Amazing hacking and making projects 
from the makers of MdgPi magazine 
Inside: 

@ How to get started coding on Raspberry Pi 
@® The most inspirational community projects 
® Essential tutorials, guides, and ideas 


@® Expert reviews and buying advice 


7 Available ji : 
GP acpi.cc/Magpistore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
@ App Store > Google Play 
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Maker 
Says 
Stretch 

your pupils’ 
computational 
thinking and 
understanding 
of computer 


science 
Ohbct 


MEARM PI 


Arobotic arm 
that you can 
control with 
the Raspberry 
Pj. It's a little 
less hackable 
than the 
Ohbot, though. 


ze 
£70 /$96 
magpi.cc/2waqp7b 
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OHBOT PI 


The educational robot face now comes with a Raspberry Pi 
version. How educational is it, though? 


e’ll be honest, the first 

time we saw the Ohbot 

we thought it was a little 
creepy. You can’t help but be 
drawn to the eyes on the almost 
skeletal face, especially when 
it?s not moving and forever 
unblinking. It’s like some kind 
of biology classroom specimen 
reject. The reason we’re bringing 
this up is because we expect other 
people might think the same and 
we can tell you, right off the bat, 
that this slight sense of unease 
does dissipate quite quickly when 
you’re up close and personal 
using one. 


2018 


Face the facts 
With that out the way, let’s 
actually look at the Ohbot. It’s a 
robot face that you can program in 
Windows and now with a Raspberry 
Pi. It has a series of motors you can 
control that give it a wide range 
of head-like movement - froma 
simple rotation of the head to even 
being able to replicate blinking 
and lip movement. Yes, it has 
(metal) lips. 

The version we reviewed 
came pre-constructed, with the 
robot held snugly in its box to 
keep it intact. However, you can 
get a slightly cheaper version 


(£119/S164) that you can construct 
yourself. The instructions suggest 
that it might take an hour or so 

to build, which sounds about 
right if you’re an adult giving 

it your full attention. The parts 
are quite big and nothing is too 
fiddly, so supervising a younger 
maker would be a good way to get 
them to understand the device 
they’re building. 

One of the motor connections 
on pre-constructed version we 
received had wiggled free in 
transit, so it’s worth giving the 
instructions a quick once over even 
if you did get the pre-constructed 
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OHBOT PI 


| U 


version, to make sure yours 
survived the trip. Once complete, 
though, it sits nice and sturdily on 
a surface, just waiting for you to 
connect it all up. 


Program with Pi 

Connecting the Ohbot toa 
Raspberry Pi is pretty simple - all 
you need to do is hook it up via the 
special USB cable that comes in 
the box. This special cable splits on 
one end into two USB connectors - 
one with a red bead on the end that 
you need to plug into a USB power 
supply, and the other which goes 
into the Pi itself. There are no extra 
power supplies to connect and you 
don’t need to wire anything into 
the GPIO. 

The Ohbot is controlled with 
Python code, and you can install 
all the necessary libraries from the 
Terminal. There are instructions 
on what you need to install in the 
kit and on the website and it won’t 
take you more than a couple of 
minutes to get ready. 

Once installed, you can try 
out the example code or start 


of the motor, and 2 is the motor 
speed. You can substitute the 
motor number for a predetermined 


The presentation, design, and 
look of the Ohbot has grown on us 
during the course of this review 


programming your own routines 
by controlling the range of motion 
and speed of each individual 
motor. If you were counting 
during construction, you’ll have 
noticed there are seven motors in 
the head - all of which are under 
your control. 

The Ohbot Python library is not 
the easiest thing to use, though. 
For example, if you want to turn 
the head, you’d need to use: 


ohbot .move(1,3,2) 


Here, 1 is the motor controlling 
the head, 3 is the new position 
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name, which in this instance would 
be ohbot . HEADTURN. 

Perhaps this slightly tricky way 
of coding the robot will pay off in 
the long run with younger makers, 
forcing them to refer back to the 
documents and really learn how 
functions in Python work. At the 
very least, though, the text-to- 
speech function is automatic. 


Talk to me 

Using ohbot. say in a similar way 
to the Python 3 print command, 
the Ohbot will talk. Or at least, 
the string of text will be converted 
to sound and played through the 


T TF 
x6 x6 


TT 
x2 xl 


speaker while the lips move to 
approximate the words being said. 
It works quite well, and it’s fun to 
watch Ohbot chat away. Of course, 
you can control this as well, 
turning off the lip sync and adding 
delays to the audio and such. 

It’s definitely a very interesting 
and unique bit of kit. The 
presentation, design, and look of 
the Ohbot has grown on us during 
the course of this review and we 
think that kids will get a kick out 
of making it talk and move around. 
Hopefully they’ ll learn something 
in the process as well. 


{ast word 


A fun educational project with 
a lot of potential. However, the 
Python library could be slightly 


easier to use. It works well with 
the Pi, though. 
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Maker 
days 


A 


Raspberry Pi 


gudio add- 
on board for 


gudiophiles 
Nanomesher 


PI-DAC PRO 


Asimpler but no 
less powerful 
DAC, the Pi-DAC 
PRO includes 
just about 
everything the 
NanoSound 
DAC has, albeit 
without the 
built-in buttons 
and screen. 


£42 / $58 
magpi.cc/2DmpYJM 


DAC 


here are a number of DACs 


available for the Raspberry 


Pi - digital-to-analogue 
converter add-ons that let you 
play high-quality audio from 
the Pi. We’ve reviewed many of 
them in past issues of The MagPi, 
so it’s always interesting to see 
a DAC do something different. 
The NanoSound DAC Pro from 
Nanomesher is one of these 
devices that sets itself apart. 

Like a lot of DACs, it comes as a 
HAT add-on for the Raspberry Pi, 
sitting snugly on top of the GPIO 
pins. This one covers the entire 
board, going over the top of the 
USB and Ethernet ports of a full- 
sized Raspberry Pi (think B+, 2, 3, 


Y etc.). However, it does this to offer 


more options -— namely a little LCD 

screen and some physical buttons. 
These buttons and screen are 

one of the most interesting parts 
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NANOSOUND DAC PRO 


O 
PRO 


A powerful DAC that also easily lets you build your own 
music box with an informative screen 


of this solution, allowing you to 
use the Pi and the DAC together as 
an all-in-one music player which 
you can then hook up to your 
favourite speakers. There’s even a 
3D-printed case you can get, with 
the files downloadable for free. It 
all works together with Volumio, 
an open-source music player that 
works on the Pi and is optimised 
for playing your music in the 
highest quality possible. With a 
few tweaks you can get it to accept 
the button inputs of the DAC and 
display song information on the 
screen, which is very smart. 

The kit even comes with a 
remote control you can control the 
system with as well. It’s a really 
neat little package, and it still 
outputs the great-quality sound 
it’s primarily meant to do. 

As well as the fully featured Pro 
version we reviewed, there is a 


SOUND 


cheaper Basic version for S48 / £35 
that doesn’t come with a screen 
if you don’t need it (although you 
can get a kit to solder one on). At 
the very least it does come with the 
buttons and the remote, which are 
arguably more important than the 
screen anyway. 

It’s a great bit of kit, and 
maybe something to consider as 
an alternative to our music box 
tutorial on page 20 of our media 
player projects feature... 


{ast word 


A lovely all-in-one music box 
solution for your Raspberry 
Pi that adds everything you'd 


need bar speakers. It sounds 
good as well. 
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FOUR 
LETTER 
PHAT 


The Four 
Letter pHAT 
displays letters 
or numbers. 
Combine it 
with the Button 
SHIM ona Pi 
Zero to make 

a compact 
alarm clock. 


£10/$11 
magpi.cc/2miVr5e 
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BUTTON SHIM 


Maker 
says 
Five handy 
physical 
buttons 
and an RGB 
status LED 


Pimoroni 


BUTTON SHIM 


Add some buttons to your Raspberry Pi, without sacrificing 
any GPIO pins. A great way to upgrade an output HAT! 


he Button SHIM from 
Pimoroni adds five buttons 
and an LED to your 
Raspberry Pi. So far, so simple. 
What’s neat about it is that it gives 
you full use of all of your Pi’s pins. 
The GPIO pins poke through the 
SHIM so you can get to them. 
Most obviously, that means 
you can use the Button SHIM 
to add some input controls to 
an electronics project. If you’re 
running out of GPIO pins, getting 
five buttons for free is a real plus. 
The Button SHIM also plays 
nicely with many HATs, so you 
can use it to add input controls to 
an output HAT. The Unicorn HAT, 
for example, provides a grid of 
colourful LEDs that can be used 
for visual displays or scrolling 
messages. By adding buttons, 
you can create more flexible 
applications that can run without 
a keyboard. 


The buttons stick out above the 
top edge of your Raspberry Pi. As 
a result, your Button SHIM project 
is unlikely to fit in an existing Pi 
case. Positioned at a right angle, 
the buttons press in towards the 
Raspberry Pi, and are labelled from 
AtoE. 

To set up the SHIM, you’1l need 
to be competent with a soldering 
iron. The SHIM has a set of holes, 
so you Slide it over your GPIO pins. 
You then need to solder several 
of the Raspberry Pi’s pins to the 
board. It’s a good idea to solder 
an additional couple of pins at 
the other end of the board to help 
hold the SHIM in place. As with 
anything that involves soldering 
the GPIO pins, it’s an unavoidably 
fiddly job because the pins are only 
a few millimetres apart. If there is 
any excess solder on a pin, it might 
stop a HAT from sitting on the 
GPIO pins properly afterwards. 


There is also a female header 
included which you can solder to 
the Button SHIM if you want to use 
it by itself. 

The RGB LED in the corner of 
the board is a great bonus, and 
ideal for adding status signals to 
a project. The rainbow example 
program shows how the buttons 
can be used to change the light 
colour. It’s a great ‘hello world’ 
demo, and a perfect showcase for 
the Python library. 


{ast word 


Aconvenient and compact 
way to add some controls 

to a Pi project or HAT. The 
Python library and examples 


will get you up and running 
quickly, and the status LED 
is a nice bonus. 
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preposterous 


pile of 
peripherals 
on your Pi! 
Pimoroni 
Get your Pi to wear several HATs, or pHATs, at the same time 
imoroni’s pHAT Stack supplied for secure mounting of Other suggested setups include 
enables you to use HATs and pHATs. an alarm clock (Four Letter pHAT, 
multiple add-on boards While it’s very easy to mount the Touch pHAT, and Speaker pHAT 
simultaneously with your add-on boards on the pHAT Stack, and a weather station with built- 
Raspberry Pi. Also available asa one caveat is that not all of them in dashboard (Enviro pHAT, Four 
solder-yourself kit (or just a PCB will play nicely with each other: you Letter pHAT, and Scroll pHAT). You 
board), the Stack is equipped with need to look out for those that use could even solder a female header 
five sets of 2x20 pin headers, the same GPIO pins. Pimoroni’s to a Pi Zero and mount that on the 
plus one to connect to the Piviaa ‘pHAT Stack configurator’ online Stack’s bottom header, rather than 
GPIO ribbon cable (supplied). This tool comes in handy here: hosted using the ribbon cable. 
FULLPHAT means there’s room to connect five _ at the ever useful pinout.xyz, it 
For those smaller pHAT boards, three full- lets you simulate adding various {ast word 
sel el size HATs, or a mixture of both. HATs and pHATs to the Stack and 
breakout board, While this might seem like will warn you of any pin conflicts. Whether you use it for a 
the FullpHAT overkill, it provides a convenient Multiple boards may still use specific project or just for 
allows youto way to switch in and out different the same [°C pins (BCM 2 and 3) experimenting with combining 
connect two i 
BHATS arene HATs and pHATs and create your without issues, so long as they use various pHATs and HATs, the 
pHAT and a HAT own custom combinations. So different addresses. PHAT Stack is a well-designed 
SESE it’s ideal for experimenting with In our test setup, we combined breakout board that should 
* hardware project ideas. a Speaker pHAT, Drum HAT, and prove useful. You just need 
@ One nice touch is that the three Piano HAT to create a mini music fe waten OnE Tose ee 
g . . F +) . conflicts - and check that the 
me) of the GPIO headers have their box, following Pimoroni’s online cable is connected the right 
pins fully labelled, which should guide (magpi.cc/2qJbcYG). This ? 
' way round on the Pi! 
£8/$11 prove handy for connecting up worked well, even though the 
your own circuits and sensors. pHAT Stack configurator flagged up 


magpi.cc/2ku3dfc 


Brass standoffs and screws arealso _a possible pin conflict on BCM 21. 
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ZEROVIEW MINI 


Maker 
says 
Can be 

mounted on 

windows, 
glass, fish 
tanks, and 


more 
Pi Hut 


ZEROVIEW WV 


Fix your Pi Camera to a window looking out, 


ADAFRUIT 
RASPBERRY 
Pl CAMERA 
BOARD CASE 


This dinky case 
snaps together 
and includes a 
standard tripod 
mount on the 
back. Use the 
holes on its 
side to tie 

it in place. 


") £3/$3 
magpi.cc/2mmGKOT 
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or to any smooth surface looking into the room 


he Raspberry Pi Camera 
Module can be tricky to 
position. It’s small, light, 
and can flop about on the end of 
its connecting cable. While it’s 
possible to improvise something 
with LEGO, Blu Tack or Sellotape, 
there’s no real substitute for a 
proper mount that’s designed for it. 
That’s what the ZeroView Mini 
is. It?s made from printed circuit 
board, although the printing is 
purely decorative. There are four 
holes for screwing your Pi Camera 
Module in the middle of the board, 
and a cut-out shape for the camera 
to point through. 
At each end of the board is a 
hole for fixing a suction cup. The 
suction cups fit the board well with 
no risk of movement or slipping. 
The Pi Hut team say they have 
sourced the best suction cups 
they could find, made by Adams 
in the US. They are about 2cm in 
diameter (unsquashed) and fix 


well to glass and smooth wood, 
supporting the weight of the 
camera easily. 

The Pi Hut makes an alternative 
product called the ZeroView, 
which enables you to screw your 
Pi Zero to the camera mount too. 
It’s the better choice for projects 
that mount the Pion glass. The 
ZeroView Mini is ideal when you 
have a larger model Raspberry Pi, 
or need the Pi to sit on a surface, 
perhaps because you have circuits 
connected to the GPIO. 

You can fit the suction cups 
into the board either way around, 
so you can use the mount to fix 
a camera to a window looking 
out — or to a window or cupboard, 
looking into a room. 

The mount gets your lens about 
a millimetre away from the glass, 
which helps to reduce reflections 
from inside the room. One of the 
suction cups was being reflected 
in our images, though, so we 


improvised a solution by removing 

it from the board and resting 

the board on it. Your results will 

depend on your setup and lighting, 

but you might need to experiment. 
The unit is supported by the 

manual for the big brother 

ZeroView, so you’ll need to make 

allowances for the differences 

in the units. It’s simple to set 

up, though, and there are some 

tips on getting started with the 

camera included. 


{ast word 


The ZeroView Miniisa 
well-made mount for your 
Raspberry Pi, with high-quality 
suction cups. Careful camera 


positioning and lighting 
control remain important to 
avoid reflections, though. 
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RASPBERRY PI 
BESTSELLERS 


Science, Technology, Engineering, and 
Mathematics are no longer a neglected 
part of education. Hurrah! 


HACKING THE CURRICULUM: CREATIVE 


COMPUTING AND THE POWER OF PLAY 


Authors: lan Livingstone, ae van 
Shahneila Saeed HAC ~K | iG. 
Publisher: John Catt p ‘UR °) CU 

P Gav OTE ine ee 
Price: £14 bet iy 
ISBN: 978-1909717824 P eS 


magpi.cc/2meRcY8 


Through emphasising the role 
of play, STEM education can oo. 
be transformed. If you missed 
out on the cover-mounted copy 
with our sister publication, Hello 
World, get a copy now (or get a 
second copy and pass it on!). 


COMPUTATIONAL THINKING AND 
CODING FOR EVERY STUDENT: THE 
TEACHER'S GETTING-STARTED GUIDE _ 


Authors: Jane Krauss, = 
Kiki Prottsman 
Publisher: Corwin 
Price: £19.99 

ISBN: 978-1506341286 
magpi.cc/2mdOgiR 


Great resources and lesson ideas 
for any teacher struggling with 
the appearance of computational 
thinking in the curriculum. US- 
made, but useful everywhere. WilL 
not only demystify the topic, but 
inspire as well. 


AN ADVENTURE IN STATISTICS: 
THEREALITYENIGMA = =—___— 


Author: Andy Field 
Publisher: SAGE 
Price: £32.99 

ISBN: 978-1446210451 
magpi.cc/2menbrx 


The least glamorous of the STEM 
subjects, despite its key role in 
data science; Professor 

Field could single-handedly 
change that. A narrative-driven 
introduction to statistics, with 
humour, and even graphic novel 
elements. Recommended. 
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COOL SCRATCH 
PROJECTS IN 


EASY STEPS 


Author: Sean McManus 
Publisher: In Easy Steps 
Price: £10.99 

ISBN: 978-1840787146 
magpi.cc/2me3yQu 


Cool Scratch 2 


Projects 


Here’s a book 
that lives up to its 
title - these are 
some cool Scratch projects to keep 
you going after learning at school, 
Code Club, or from a Raspberry Pi 
introductory book. Given Scratch’s 
user-friendliness, it’s also suitable 
for complete beginners, and the 
first project, a Magic Mirror, is 
designed to get everyone up to 
speed while still being fun for more 
experienced users. 

The book gives equal coverage to 
Scratch 1.4 and Scratch 2.0 — great 


TEXT MINING 
IN PRACTICE 
WITH R 


Author: Ted Kwartler 
Publisher: Wiley 
Price: £50 

ISBN: 978-1119282013 
magpi.cc/2mgajkK 


Text mining — “distilling 
actionable insights from 
text,” as the author puts 
it — certainly has academic uses, but 
here we’re concerned with the kind 
of automation that everyone from 
tiny startups to large enterprises can 
use to automate processes and try 
to get ahead. With so much online 
content produced by customers, 
millions (billions!) of words of text 
are a resource waiting to be tapped. 
In the introductory chapter, 
the case is examined of Amazon’s 
early engagement with customers 
through social media — text-mining 
the competition’s responses on 
social media to look for best practice 
~ after explaining the balance 


for the many Pi users sticking 

with 1.4. Most projects will run 

anywhere, but for Pi users there’s 

also a chapter with the Raspberry 

Pi Camera Module. Before that are 

projects involving drawing, 

* animation, drums (!) and plenty 
of games. Early on, you get to 
program 12 Angry Aliens with 
(drumroll please...) 3D effects. 

Yes, the book includes 3D 
glasses, and you get to program 
for them in other games, such as 

Space Mine and Maze Explorer, as 

well as in an art app with random 

elements. Final chapters introduce 

ScratchJr — useful for trying out 

quick ideas, as well as for younger 

coders — and five ‘shorties’, quick 
projects to finish. If you got a Piand 

a book for Christmas, this will make 

a great follow-on. Recommended. 


Score 


needed between algorithm and 
domain knowledge: ‘text mining is 
part art and part science’. Having 
launched the social 
media customer 
service team at 
Amazon, then worked 
on similar analytics 
projects at other large 
companies, Kwartler 
is as well versed in 
the practical problems 
of text mining as the 
theoretical side. 
Chapters on 
visualisations, sentiment scoring, 
hidden structures, document 
classification (using supervised 
learning to detect clickbait), 
predictive modelling, 
and natural language processing 
with OpenNLP all do a first class 
job of showing messy real-world 
data and how to handle it, with 
sufficient theory and R to build 
upon further. An enjoyable and 
informative journey. 


Score 
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LEARN JAVA 
THE EASY WAY: 


A HANDS-ON 
INTRODUCTION TO 
PROGRAMMING 


Author: Bryson Payne 
Publisher: No Starch 
Price: £22 ($29.95) 

ISBN: 978-1593278052 
nostarch.com/learnjava 


Python and the Raspberry Pi 
have been a good fit together, 
the scripting language that reads 
almost as pseudocode makes a 
great introduction to coding. Java, 
on the other hand, is a harder 
sell for beginners: strict typing, 
all that boilerplate, and so big 
that most Java programmers 
have to lean heavily on their 
IDEs. Yet Java remains the most 
used programming language 
professionally, and its JVM the 
gateway to dozens more, so it 
cannot be ignored. 


DOCS LIKE 
CODE 


Author: Anne Gentle 
Publisher: Lulu.com 
Price: £14 ($19.95) 
ISBN: 978-1387081325 
docslikecode.com 


Docs as code? 
Documentation 
is an integral part of the 
software ‘product’, and if it is 
not always treated as such, then 
everyone involved in software 
needs to think about why. 
Technical writers can do their part 
by matching their workflow with 
that of a project’s programmers, 
and using the same tools — placing 
the documentation within easy 
reach of coders, and removing 
friction from the involvement of all 
team members. 

Gentle, a key figure in the Write- 
the-Docs group, which is doing 
much to bring best practice to the 
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LEARN 
THE EA JAVA 


If only there were a book that 
launched the reader past the 
boilerplate of static, void, main, 
and int, and got them coding up 
something fun straight away. Enter 
Bryson Payne. Dr Payne brings his 

easy, flowing style to 

Java learning, and gets 

the reader coding fun 

programs immediately; 
first by copying, then 
stretching through 
further challenges. 
Eclipse and Android 
Studio are used heavily 
throughout; unlike Python, getting 
things done quickly in the Java 
environment needs good tooling, 
and these are sensible choices. 
Text-based and graphical games 
alternate as areas of programming 
are introduced, and Android makes 
an early appearance, capped with 
animation programming. An 
excellent introduction. 


Score 


writing of technical documentation, 
gives us a short introduction 
outlining all the main messages 
of docs-like-code: storage in 
version control (GitHub, GitLab, 
BitBucket); automatic doc 
artifact builds; trusted reviewers; 
and publishing without much 
human intervention. 
The documentation workflow 
is introduced and outlined, with 
due time spent on Continuous 
Integration, review, and useful 
topics like REST APIs, and 
measuring improvements — as well 
as examining some of the many 
technical questions which shouldn’t 
dominate your strategic decision in 
choosing how to set up a document 
toolchain, but are unavoidable 
considerations. This beginner- 
friendly guide will leave you with 
no excuse not to get your project’s 
documentation off to a great start. 


Score 


ESSENTIAL READING: 
HADOOP & SPARK 


The perfect excuse to set up a Raspberry Pi 
cluster for Big Data experiments. 


Teach Yourself Hadoop 
in 24 Hours 


Author: Jeffrey Avens 
Publisher: SAMS 
Price: £39.99 

ISBN: 978-0672338526 
magpi.cc/2mfKH7D 


Awhirlwind review of the possibilities 
of the platform, taking in the core 
concepts and all of the components. 


Pro Hadoop Data Analytics 


Author: Kerry Koiltzsch 
Publisher: Apress 
Price: £31.99 

ISBN: 978-1484219096 
magpi.cc/2mdDoi6 


High-level but code-rich guide to 
getting the most from Big Data, mostly 
Java, but some Scala and Python. 


Professional Hadoop 


Authors: Benoy Antony, Konstantin 
Boudhik, Cheryl Adams, Branky Shao, 
Cazen Lee, Kai Sasaki 

Publisher: Wrox 

Price: £42.50 

ISBN: 978-1119267171 
magpi.cc/2meRFtm 


If you need to get up to speed on 
Hadoop, particularly as a DBA or an 
architect, this is the quickest intro. 


Spark in Action 


Authors: Petar Zecevic and 
Marko Bonaci 

Publisher: Manning 

Price: £30.99 

ISBN: 978-1617292606 

magpi.cc/2mdAngg 


The Spark framework complements 
the Hadoop ecosystem; the book's Scala examples are 
downloadable in Python (and Java) versions. 


Practical Data Science with 
Hadoop and Spark 
Authors: Ofer Mendelevitch, 

Casey Stella, Douglas Eadline 
Publisher: Addison-Wesley 
Price: £35.99 
ISBN: 978-0134024141 
magpi.cc/2meo1Vd 


More of a data science introduction, 
but very good on introducing 
Hadoop's role in that world. 
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FOLLOW MISSIONS 
LEARN PROGRAMMING 


Special $10 MagPi coupon: 


only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ° 
| gf | 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 


a A 


SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 


Supported by Top University Funds 
; Stanford-StartX Fund 
Cad AEF of Princeton University 


Available at: 
BuildPiper.com amazon ys$iu BARNES<NOBLE 


A PI-POWERED 


Setting up a3D print farm with Raspberry Pis You can 


was a no-brainer for the team at PRODPOINT 


a 
| 
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even 3D-print 
shoe soles! 


ay back in issue 55 of 

The MagPi, we showed you 

how to make a Pi-powered, 
Game Boy-esque handheld retro- 
gaming system. The shell for this 
project was printed by PRODPOINT, 
at the time a small operation 
running out of Felix Fried’s 
bedroom in Bournemouth. Since 
then, PRODPOINT has expanded to 
be a true 3D-printing factory. 


Tell us about your 3D print farm 
So our ‘print farm’ consists of 
an array of 3D printers, currently 
24 of them and counting. We 
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produce hundreds or thousands 

of parts each week for companies 
who’ve decided 3D printing is a 
better solution for production over 
traditional manufacturing methods 
like injection moulding. We help 
designers and engineers scale up 
their ideas from the prototype 
stage to production by leveraging 
FDM 3D printing. 

For a lot of projects, the key 
benefit is that we manage to 
reduce much of the production 
costs, as well as accelerating the 
time to market for our clients. 
Others decide to use us because 
it gives them the flexibility of 
producing smaller batches without 
ever having to commit much 
capital. If they decide to make 
design changes, they can receive 
their updated design in days at 
minimal cost. 

Traditional methods like 
injection moulding require 
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investing in an expensive mould, 
these can be a hefty investment 
(up to £30k+) and can take 
several weeks to produce. When 
things go wrong and the mould 
needs repairing or the design 
changed, companies are left 
with nasty bills. We remedy this 
by providing fast, flexible, and 
affordable manufacturing. 


After a few years of doing this as a 
student, I began to get approached 
by companies looking to get 
batches produced, some of which 
were fairly large orders for me at 
the time, and would’ve taken a 
gazillion hours without an army 
of printers. This led me to ponder 
on the idea of starting a factory or 
‘print farm’. 


While we didn't coin the term 
print farm, we've grown a 
particular liking to it 


While we didn’t coin the 
term print farm, we’ve grown 
a particular liking to it after 
harvesting prints daily — it’s a bit 
of an ongoing joke but we might 
decide to install fake grass and 
print cows for the factory... just 
*cause we can. 


How did the idea come about? 

I’m not sure there was ever a 
light-bulb moment as such. I 
started building 3D printers around 
six years ago and decided to run 
my printer to help university 
students produce their projects. 
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Why the Raspberry Pi? How are 
they being used? 

We use Raspberry Pis to keep all of 
our printers connected on a local 
network. This allows us to control 
and monitor them from one 
single interface we programmed 
in-house. We chose Raspberry 

Pi as they’re super-powerful 

for such an affordable bit of kit. 
Currently we run three printers 
per Pi. We’ve also managed to 
add cameras for off-site remote 
monitoring and mini LCD screens 
to track which order is being 
printed on each printer. 


With 
24 3D printers 
running non-stop, 
sometimes they 
need to takea 
break for a bit of 
love and attention 


You can 
3D-print more than 
just gears, but 
they are a perfect 
candidate fora 
bulk-buy 


How popular has the service 

been so far? 

We’ve only been up and running as 
a print farm for a few months now 
but demand has been consistently 
growing. We’re now working 

in several industries including 
pharmaceutical, automotive, film, 
and consumer. I guess we’re in-line 
with our predictions so far, but who 
knows what the future will bring? 


February 2018 MagPi | 85 


Community 


THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


100+ JAMS 


CONFIRMED FOR 
RASPBERRY PI'S 


BIRTHDAY! 


RASPBERRY JAMS WILL BE HELD AROUND THE WORLD 
TO CELEBRATE THE BIG BIRTHDAY WEEKEND 


a6 | MagPi February 2018 


or the past few years, the 
F Raspberry Pi Foundation 
has organised its own 
birthday party in the form of a 
weekend-long Raspberry Jam. Not 
everyone can make it out to the 
one Jam, though, so this year the 
call went out to the community 
to host Jams around the world 
in honour of the Raspberry Pi on 
the weekend of 3 and 4 March. 
Applications to be a part of it have 
recently closed and a whopping 
102 Raspberry Jams will be 
taking place around the world 
to celebrate. 
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(Perth, Australia) 


Glenunga International High School 
Raspberry (Glenunga, Australia) 


Varna Raspberry Big Birthday 
Weekend 2018 (Varna, Bulgaria) 


Dojoberry 


Raspberry Camer 
(Yaounde, Cameroon) 


MyPi Toronto (Ontario, Canada) 


Ottawa - Big Birthday Bash 
(Ontario, Canada) 


Pi min (Ontario, Canada) 
Imen (Paris, France) 


Ungeheuer Raspberry 
(Forst, Germany) 


Aketh Innovation Robotics Lab 
(Trikala, Greece) 


MalnaPi 
Raspberry Pi BD 
(Budapest, Hungary) 
Arihant’s ———_ (Odisha, India) 


BIT-D Raspberry 
(Chhattisgarh, India) 


Indore Raspberry — 
bigbirthday 
(Chidambaram, India) 


Kanpur Raspberry 
(Kanpur Nagar, India) 


(Somogy, Hungary) 


(Indore, India) 


Mumbai Raspberry 
(Mumbai, India) 


MyFirstPOC (Ahmedabad, India) 
Next Tech Lab ~ 


ResPro Raspberry Pi Labs 
(Chennai, India) 


(Chennai, India) 


RIT Raspberry (Chennai, India) 


Trivandrum Raspberry 
(Kerala, India) 


Babol Raspberry 
(Mazandaran, Iran) 


Kajestan (Isfahan, Iran) 


Raspberry Cagliari 


(Cagliari, Italy) 
SuLuLab Raspberry 


Raspberry in Hamamatsu 2018 
(Hamamatsu, Japan) 


Raspberry Tokyo (Tokyo, Japan) 


Tabaka Boys’ High School 
Raspberry (Kisii, Kenya) 


(Terni, Italy) 


Voi Raspberry (Voi, Kenya) 


Raspberry Penang 
(Penang, Malaysia) 


MaltaPi (Attard, Malta) 
Pifia pi (Ecatepec, Mexico) 


Amster 
(Amsterdam, Netherlands) 


Kristiansand Raspberry 
(Vest-Agder, Norway) 
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Lima Raspberry Verano 2018 


(Lima, Peru) 


RPi Birthday with loT Cebu 
(Cebu, Philippines) 


RPi CT (Cape Town, South Africa) 


Raspberry 
Spain) 


Granada (Granada, 


4th Annual Hisar Coding Summit 
(Istanbul, Turkey) 


Batley Library Raspberry 
(West Yorkshire, UK) 


Beeston Raspberry 
(Nottingham, UK) 


Birmingham Raspberry 
(West Midlands, UK) 


Blackpool Raspberry 
(Lancashire, UK) 


Bognor Regis Raspberry 
(West Sussex, UK) 


Cardiff Family (Wales, UK) 


Cornwall Raspberry - Big 
Birthday Event (Cornwall, UK) 


Cotswold Raspberry 
(Cheltenham, UK) 


(West Midlands, UK) 


Dundee Raspberry 
(Scotland, UK) 


East London and Covent Garden 
(London, UK) 


East London 


Coventry R 


(London, Uk) 
Exeter Raspberry (Devon, UK) 


Gateshead Raspberry 
(Tyne and Wear, UK) 


Glasgow Raspberry 
(Scotland, UK) 


Huddersfield Raspberry 
(West Yorkshire, UK) 


Hull Raspberry 
(East Yorkshire, UK) 


Ramma (Greenwich, UK) 


ming in Marlborough Birthday 
Weekend (Wiltshire, UK) 


Kendal Raspberry 


(Cumbria, UK) 
Kent Raspberry (Kent, UK) 


Leeds Raspberry 
(West Yorkshire, UK) 


Manchester Raspberry 
(Manchester, UK) 


Meety Pi Club (Dorset, UK) 


Milton Keynes Raspberry 
(Bletchley, UK) 


Nantwich Raspberry 
(Cheshire, UK) 


Newhaven Raspberry 
(East Sussex, UK) 


Newport Family (Wales, UK) 


Northern Ireland Raspberry 


(Belfast, UK) 
Northumbria (Tyne & Wear, UK) 
Oxford Raspberry (Oxford, UK) 


Potton Pi and Pints 
(Bedfordshire, UK) 


Preston Raspberry 
(Lancashire, UK) 


Raspberry @ Worksop College 
(Nottinghamshire, UK) 


South London Raspberry — 
(London, UK) 


Southend Raspberry 
(Essex, UK) 


Stokers 


Sandwich 


(Chelmsford, UK) 
Swansea (Wales, UK) 


Taunton GlassBox Big Birthday 
Weekend (Somerset, UK) 


TechTribe.UK Raspberry 
Birthday Party (London, UK) 


Ann Arbor Raspberry Pi Birthday 
(Michigan, USA) 


Bucks Raspberry 
(Pennsylvania, USA) 


Cocoa Raspberry (Florida, USA) 
(Texas, USA) 


Key Tech Labs Raspberry — 
(Washington, USA) 


Long Beach Public Library 
(New York, USA) 


MAKEmory Raspberry 
(Georgia, USA) 


Nerdvana's 1st Raspberry 
(Texas, USA) 


Norski (Wisconsin, USA) 


Philly & Pi Bithday 
(Pennsylvania, USA) 


Pi Kids Garage (North Carolina, USA) 


Raspberry Pi Hack-a-thon 
(Maryland, USA) 


Raspberry Pi Miami (Florida, USA) 


RGVSA's First Raspberry 
(Texas, USA) 


Riverside Raspberry 
(California, USA) 


Roanoke Raspberry 
(Virginia, USA) 


Rock the Rasp (Maryland, USA) 
Rose Cyber (Oklahoma, USA) 


Seattle Raspberry 
(Washington, USA) 


Stemgirlz/GWC Raspberry 
(Pennsylvania, USA) 


ColleyVine 


Raspberry Team Masvingo 
(Masvingo, Zimbabwe) 


FIND OUT 


MORE INFO 


Want to get precise 
details on your local 
Pi Birthday Jam? 
Head over to the 
Raspberry Jam page 
for an interactive 
map and links to the 
individual Jams here: 
magpi.cc/28Nxeff 
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he holiday break is traditionally seen as being @Q onl heute 

relaxing. Taking a break from it all. To some 

of our readers, that meant having time to ete 
work on their projects or figure out what they want | assembled a YouT ube chicken camera! 
to do in the new year. Here’s some of the cool stuff youtu.be/O laN3GajyM 


you’ve sent us! 


@ David Pride 


age 
j 


@TheMagP1 Santa brought me my first ever 
successful compilation of OpenCV on 
#RaspberryPi Training for #PiWars 
Rainbow Challenge begins in earnest... 


Andrew Lewis showed us his new YouTube chicken camera, 
which you can see him assemble on his lengthy YouTube 
video! It's made by taking an old CCTV camera case and 
installing a Pi Camera into it. Ingenious. 


“s Elijah Horland 
In preparation for the upcoming Pi Wars, David Pride managed 
to get OpenCV working on his robot to be able to tell colours 


apart! Watch the video in the original tweet to see just how My teachers responded really well to this 
well it's been mastered. ‘ . oa “ it penton? 
year's gifts - @adafruit "JoyBonnet" mini 
game-system gifts inspired by #AdaBox 
005 - but with soldered headers. This is 
7 my vice principal, my STE(a)M teacher 
and my English Language Arts teacher. 


(A, Mike Golf Romeo 


eplying to @TheMagP 1 


Ambilight (Hyperion) with 316 APA102 LEDs 
with arduino to drive them :) 


One of our younger readers, Elijah put together some very 
special gaming holiday gifts for his teachers. We hope his 
English teacher gets a kick out of it. 


Ambilight tech can really make your TV viewing enter a new 
dimension, as shown by Baconvernichter on Twitter. We saw 
a few other people create amazing solutions to this over the 
holiday break as well! 


88 | MagPi February 2018 raspberrypi.org/magpi 


THIS MONTH IN Pl 


CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out.. 


OMNI @@ JOY 


OMNIJOY suicesox zero 


kck.st/2Cjq40l i : = 7a Dev J | 


This is a special case for the Pi Zero that turns it into We quite like this. It?s a HAT you can slot on top of a 
a handheld controller with a screen in the middle. Pi and connect a 3.7 V lithium-ion battery to. You can 
It’s got a wooden grip so it’s pretty fancy as well. also charge it via the HAT. While there are other more 
The concept is that, as an all-in-one device, you can complex HATs that do the same (such as the excellent 
use it in your projects without needing the separate PiJuice), this a great little solution that fits easily on 
computer and controller elements. It’s a little pricey top of a Pi Zero. It even gives you full access to the 
but well worth a quick look. GPIO pins as well! 


BES FORTHE RES i ii cavouas 


magpi.cc/2mEM2VR Z |) magpi.cc/2mEf7R1 magpi.cc/2mB5aEo 


AUTOMATIC 
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Spencer 
volunteers his 


time to various 
community events 
with the Raspberry 

Pi Foundation, often 
finding his way into the 
traditional Certified 
Educator selfie with 
Carrie Anne Philbin 
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From educator to club volunteer, maker, 
and blogger, Spencer Organ is the complete 
community member package 


hat’s not to love about 

Spencer Organ? As an 

educator, he has fully 
immersed himself into the 
Raspberry Pi community, running 
clubs, teaching computer science, 
volunteering, and advocating 
the Foundation. And as a maker, 
he has embraced his educator 
mentality to provide tutorials and 
support for every project he’s 
released into the wild — and believe 
us, Spencer loves to make. 

With a degree in Chemistry and 
Education, and his qualification 
as a Picademy-trained Raspberry 
Pi Certified Educator, Spencer 
teaches Physics and Computer 
Science in Birmingham, UK. 


ar 


PT Sa 


Spencer Organ dedicates his time and passion to bringing computer 


2 


Between classes, he offers up his 
spare time to running Raspberry 
Pi and coding clubs at the school, 
along with volunteering at a Code 
Club, Raspberry Jam events, the 
Raspberry Pi Birthdays, school 
holiday clubs and much more. 

You may well recognise Spencer’s 
name from one of several projects 
showcased previously in The MagPi. 
Inspired by everything around him, 
Spencer creates fun, imaginative 
builds — both alone and with his son, 
Philip. We should take a moment 
to highlight Philip’s incredible Pi- 
powered Pokédex, a working replica 
of the gadget used in the popular 
Pokémon TV series to identify and 
catalogue the creatures captured. 


science to everyone through events, clubs, and maker projects 4 
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Of his computing past, Spencer 
recalls, “After getting my first 
computer, an Acorn Electron, at 
age 111 spent the next five years 
writing projects in BASIC. I must 
have completed every Usborne 
coding book from the library as 
a child. I progressed onto the 
Visual Basic unit at sixth form 
and continued writing Excel VB 
projects to simplify data tasks at 
school.” So that explains his love 


“| try to bring in CS elements into 
my Physics work and recently had students 
modelling radioactive decay in Python!” 


education into as many aspects 

as possible of the children’s lives 
that he works with is a worthy feat. 
And confirming the inclusion of 
the Arts in STEAM, he’s even gone 
on to inject the Raspberry Pi into 
school productions, including High 
School Musical and The Wizard of Oz. 
The relocated band need to see the 


I must have completed every 
Usborne coding book from 
the library as a child 


for computing and the natural 
progression into digital making 
with the Raspberry Pi. 

At the Raspberry Pi Big Birthday 
Weekend 2017, Foundation CEO 
Philip Colligan pulled Spencer 
onto the stage, from his place as 
stage manager on the sidelines, to 
highlight the work of the RCEs and 
community, recognising him to be 
“a physics teacher who’s gone on 
to become an amazing advocate for 
computing in schools.” 

Spencer’s work, often in his 
own time and at personal expense, 
to incorporate computer science 
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musical director from their hidden 
position backstage? No problem, 
here’s a live-stream video system. 
The Tinman needs a heart? Sure. 
And let’s use an LED matrix to 
make it glow. 

As we move into 2018 and 
Spencer continues to work on 
building upon his skill set — “1 
really want to develop my soldering 
skills this year and also design my 
first PCB” — we also look forward 
to seeing what further strides he 
makes within the educational 
work of the Foundation. Thank 
you, Spencer. 
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EVENT CALENDAR One 7) aa 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


Want a Raspberry Jam in 


your area? Want to start one? 
Email Ben Nuttall about it: | att = 


ben@raspberrypi.org {; HISAR CODING 
SUMMIT 


REGULAR EVENTS 


RASPBERRY JAM RASPBERRY JUNIOR JAM COFFEE, CAKE AND CODING 

NORTHUMBRIA When: Friday 16 February When: Thursday 1 February 

When: Saturday 3 February Where: Bletchley Park, Where: King Edward VI Sheldon 

Where: Ellison Building, Bletchley, UK Heath Academy, 
Newcastle-upon-Tyne, UK magpi.cc/2DgMq7c Birmingham, UK 

magpi.cc/2DdnvRN The National Museum of magpi.cc/2Dh9LWj 

Bringing together a diverse group Computing is looking to start a This monthly meeting/workshop 

of people with a range of skills Jam for young people who are just aims to enjoy coding and 

and experience. starting out with coding. computing in a relaxed setting. 

RASPBERRY JAM MASSA HISAR CODING SUMMIT EXETER 

CARRARA When: Friday 2 March RASPBERRY JAM 

When: Saturday 10 February Where: Hisar School, Istanbul, When: Saturday 3 February 

Where: [.1.S. Zaccagna Galilei, Turkey Where: Exeter Library, Exeter, UK 
Carrara, Italy magpi.cc/2msw6po magpi.cc/2Be2TZ6 

magpi.cc/2DgFN4U The goal is to share and spread There will be lots to do, plenty of 

Here you can find workshops for the essential knowledge of help and advice, and Pis to play 

beginners and for experts to work programming and algorithmic with at the Exeter Raspberry Jam. 

on their projects. thinking with everyone. All are welcome. 
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RASPBERRY JAM 
NORTHUMBRIA 


LEEDS 
RASPBERRY JAM 


PRESTON 
8 RASPBERRY JAM 


COFFEE, CAKE AND 
CODING 


RASPBERRY 
JUNIOR JAM 


hd 


EXETER 
RASPBERRY JAM 


PRESTON RASPBERRY JAM 
When: Monday 5 February 
Where: Media Factory Building, 
Preston, UK 
magpi.cc/2DdbHyV 
This Jam is acommunity of people 
who meet in Preston each month to 
learn, create, and share the potential 
of the Raspberry Pi. 


LEEDS RASPBERRY JAM 

When: Wednesday 7 February 

Where: Swallow Hill Community 
College, Leeds, UK 

magpi.cc/2DhiDLL 

There’ll be chances to get hands-on 

with more digital making activities 

through workshops and a hackspace 

area to share projects. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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BIG BIRTHDAY 
WEEKEND 


Raspberry Pi turns six this year and 
to celebrate this, the Raspberry Pi 
Foundation is co-ordinating a huge 
number of Jams around the world 

to participate in the Big Birthday 
Weekend. There are over 100 Jams 
co-ordinating events on Saturday 3 
March (and a few on Sunday 4 March) 
and you can read more about them - 
including an up-to-date list! - in This 
Month in Raspberry Pi, on page 86. 
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PIKEA HACKS 


I’m a new Raspberry Pi user and I’ve been 
marvelling at some of the amazing projects I’ve 
seen online and in this magazine. For years I’ve 
been doing ‘Ikea Hacks’, where you take a piece 

of Ikea furniture and modify it to your tastes. This 
can be as simple as making a Billy bookcase extend 
from floor to ceiling, or rearranging my TV cabinet. 
I feel like some interesting Pi projects could be 
made by combining Raspberry Pi and Ikea furniture 
- do many of these kind of projects exist? Are you 
planning on doing any articles about how to hack 
furniture with the Raspberry Pi? I hope you do! 
Sarah 


We’ve had a few furniture-based projects in the mag 
in the past — for example, last month we showed off 
someone’s Christmas lights that they’d installed into 
their Billy. There’s also the extremely cool PiDesk 
(magpi.cc/1qtTC5J) from The MagPi #43, with fancy 
lights and a rising screen. Very futuristic. As and when 
we find these projects we’ll put them in the magazine 
— as for writing a feature on Ikea hacks, we may just 
have to look into that! It’s always fun to put some 
LEDs in a display case after all. 


94 | MagPi February 2018 


The desk of the future 
- well, today, actually 


NEW RASPBERRY PI ZERO 


I saw there’s a new version 
of the Raspberry Pi Zero. 

It looks good, but does it 
mean I need to upgrade my Pi 
Zero W? Are there significant 
improvements to it over the 
other Pi Zero W? I never did 
get round to soldering ona 
GPIO header so maybe it’s 
worth me picking one up 
anyway, to save me the hassle 
of soldering the header on. 
What do you recommend? 
LeeS 


The new Pi Zero WH comes with 
a pre-installed GPIO which is great 
for projects 
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The only difference between 
the Pi Zero W and the new 

Pi Zero WH is that the latter 
includes the soldered GPIO 
header — there’s no speed or 
memory improvements on 

the board. You will pay a small 
premium to get the WH version 
over the normal Zero W though, 
so if you’re confident in your 
soldering skills and have the 
header already you should 
definitely give it a go yourself. 
You can always then buy a WH 
the next time you need a Zero 
and marvel over the professional 
soldering job. 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving for the 
community — join in via raspberrypi.org/forums 


ust a small thing, but I thought I 

would just say the review for the 

OLED Bonnet in issue 63 says the price 
is $32 when the price is actually $22. 
KanoMaster22 


In this case this was our mistake, sorry! 
Unfortunately, prices change around a lot so 
sometimes differences like this are entirely 
out of our control. Once the magazine goes to 
print, we can’t change the price on reviews 
rt. eens . - Industrial DIN rail mount 

Any typos like this, or especially any code “ 
issues you come across, please drop them off - Open frame for better airflow 
in the forum under the Errata thread. We do ‘ Integ rated USB strain relief 
endeavour to make sure the content in the 
magazine is 100% accurate, but the odd thing 
does slip through the cracks, unfortunately. 


The simple way to mount your Pi! 


The OLED bonnet - 
now $10 off! 


raspberrypi.org/magpi February 2018 MdgPi | 95 


f , 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


wa Code Club is free 


4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


Ku Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us! 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 eS 
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Hut 


www. ThePiHut.com 


Learn more: 
Magpi.cc/2FIEdXS 


We’ve teamed up with The Pi Hut to 
offer these great Media Centre Kits. 
10 lucky winners will get all of this: 


° Raspberry Pi 3 Model B 

° 16GB SanDisk Ultra Class 10 microSD 
(pre-imaged with Kodi) 

° Official Raspberry Pi5.1V2.5A 
International Power Supply 
(for UK, EU, USA & AUS) 

° Black Raspberry Pi 3 Case 

° 2m HDMI cable 

° 2m Ethernet cable 


Put everything together in the kit 
and connect it to your television 
for an instant media centre. 


Enter at magpi.cc/WinFeb18 


Terms & Conditions 


Competition opens on 24 January 2018 and closes on 22 February 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 


no cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Cs 


t’s tough to beat the Python programming 
language. It’s powerful, easy to learn, and 

is suitable for many different purposes. 
Whenever I meet someone looking to get started with 
programming on Raspberry Pi, | often suggest that 
they give Python a try. Not only is the language itself 
great for the above reasons, but the abundant free 
resources and massive community of support around 
Python make it one of the best languages out there 
right now. 

I learned to program in BASIC as a young kid 
and moved on to C and C++ as a teenager. I’ve also 
worked with a few other languages such as Java and 
JavaScript. These days, I use Python exclusively. 

I don’t mean to knock other languages; many 

have their own particular purposes and strengths. 
But if there were an award for best all-around 
programming language, | think Python should win it. 

For beginner programmers, Python is a great 
language to get started with. Its syntax is very easy 
to understand compared to most other programming 
languages out there. Python also makes it easy to 
work with different data types, which means the 
learning curve is much less steep for beginners. And 
although Python is great for people just starting out, 
it doesn’t mean that it’s only for beginners. Python 
is used in professional and academic settings and 
does some serious heavy lifting. 

I personally use Python for all kinds of projects. 
Recently, I missed out on a hard-to-get dining 
reservation for an upcoming vacation. In a couple of 
hours, I managed to write a Python script to check 
the restaurant’s online reservation system every few 
minutes for availability. If a reservation opened up, it 
would send a push alert to my phone. The script runs 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


# IN PRAISE 
~ OF PYTHON 


Matt Richardson explains why he has grown to love Python 


on a Raspberry Pi connected to my network. Thanks 
to the Python Requests library, it was easy to have my 
script submit the query through the website’s form 
and listen for a response. An easy-to-use library for 
the Pushbullet iOS app made it easy to get instant 
alerts on my phone. Iam by no means an expert in 
Python, but I couldn’t believe how quickly I was able 
to get this project working. I give a lot of credit to 
Python itself for that. 

If you’re making physical projects with Raspberry 
Pi, there’s very strong support for accessing the 
GPIO pins and working with electronics. With the 
GPIO Zero Python library, it’s very easy and intuitive 
to work with electronic components like LEDs, 
buttons, motors, and sensors. And now with the 
advent of MicroPython, you can even use Python to 
program a microcontroller such as the ESP8266 WiFi 
system-on-chip. 

Use of Python is so widespread that there’s 
pretty much a solution to everything documented 
online. Review the usage stats at sites like GitHub 
and StackOverflow. While Python might not be at 
the top of the list, it’s typically among the top five, 
and is trending towards more use everywhere that I 
checked. The more people that are using a particular 
language means a larger community of support and 
more resources for learning and troubleshooting. 

Of course, I believe that you should use whatever 
programming language you’re most comfortable 
with and the one that fits your needs the best. But if 
you’re looking for a general purpose programming 
language that’s easy to learn, is flexible, and has a 
large community support, I can’t recommend Python 
enough. I’ve jumped on the Python bandwagon and I 
haven’t looked back. 
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THE Official 
RASPBERRY PI 
EGINNER'S BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adaptors 

8GB Micro SD card 

116-page beginner’s book 
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RASPBERRY PI 


The pocket-sized desktop computer! __— g 
) PI ZERO 


store.rpipress.cc 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pi board and case 
Power Supply and HDM} cable 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$389” £69°° 


US DOLLARS EXCLUDING VAT 
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